.NET 8 DLLをVBAから型付きで呼び出す方法

まず結論

.NET 8 の DLL を VBA から型付き（早期バインディング）で使う流れはこうです。

1. .NET 8 のクラスライブラリを EnableComHosting=true でビルド
2. COM 向けの明示的なインターフェイスとクラスを作成
3. クラスは ClassInterfaceType.None、インターフェイスは InterfaceIsDual
4. ビルド後、dscom tlbexport で TLB を生成
5. regsvr32 で *.comhost.dll を登録
6. dscom tlbregister で TLB を登録
7. VBA で参照設定を追加し、型付きで利用

COM の入口は *.comhost.dll、型情報は *.tlb、VBA はその TLB を見て早期バインディングする という構成です。

全体像

最初に決めること: 32bit / 64bit を揃える

Office/VBA と COM サーバーの bitness を揃えないと「ActiveX コンポーネントはオブジェクトを作成できません」系のエラーが出ます。

.NET 8 側の作り方

.csproj

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0-windows</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <EnableComHosting>true</EnableComHosting>
    <PlatformTarget>x64</PlatformTarget>
    <NETCoreSdkRuntimeIdentifier>win-x64</NETCoreSdkRuntimeIdentifier>
  </PropertyGroup>
</Project>

ポイントは EnableComHosting=true。これを付けるとビルド時に *.comhost.dll が生成される。

アセンブリ全体は COM 非公開に

using System.Runtime.InteropServices;
[assembly: ComVisible(false)]

公開するインターフェイスとクラス

namespace VbaTypedComSample;

[ComVisible(true)]
[Guid("2A1BBEDE-DE6E-4C34-AD60-2E9E0E33E999")]
[InterfaceType(ComInterfaceType.InterfaceIsDual)]
public interface ICalculator
{
    [DispId(1)] int Add(int x, int y);
    [DispId(2)] double Divide(double x, double y);
    [DispId(3)] string Hello(string name);
}

[ComVisible(true)]
[Guid("FAD1C752-0BB6-4DDD-889F-FE446350847A")]
[ClassInterface(ClassInterfaceType.None)]
[ComDefaultInterface(typeof(ICalculator))]
public class Calculator : ICalculator
{
    public int Add(int x, int y) => checked(x + y);
    public double Divide(double x, double y) { /* 0除算チェック付き */ }
    public string Hello(string name) { /* 空文字対応 */ }
}

押さえるポイント

• Guid はインターフェイスとクラスに別々に振る
• ClassInterfaceType.None にして AutoDual に頼らない
• VBA 向けインターフェイスは InterfaceIsDual
• DispId を振っておくとメソッド順変更時の事故を減らせる
• public な引数なしコンストラクターが必要（COM から New されるため）

ビルドと TLB 生成

dotnet build -c Release
dotnet tool install --global dscom
dscom tlbexport .\bin\Release\net8.0-windows\VbaTypedComSample.dll --out .\bin\Release\net8.0-windows\VbaTypedComSample.tlb

32bit Office 向けの場合は dscom32.exe を使用する。

COM host と TLB の登録（管理者権限で実行）

# 64bit Office の場合
$out = Resolve-Path .\bin\Release\net8.0-windows
C:\Windows\System32\regsvr32.exe "$out\VbaTypedComSample.comhost.dll"
dscom tlbregister "$out\VbaTypedComSample.tlb"

VBA から使う

1. Excel/Access を開く → VBA エディタ
2. ツール → 参照設定 → VbaTypedComSample.tlb を選択
3. コードを記述:

Option Explicit

Public Sub UseCalculator()
    Dim calc As VbaTypedComSample.ICalculator
    Set calc = New VbaTypedComSample.Calculator

    Debug.Print calc.Add(10, 20)
    Debug.Print calc.Divide(10, 4)
    Debug.Print calc.Hello("VBA")
End Sub

IntelliSense が効き、メソッド名の typo が実行前に見つけやすくなる。

例外は VBA 側では COM エラーになる

Public Sub UseWithErrorHandling()
    On Error GoTo EH
    Dim calc As VbaTypedComSample.ICalculator
    Set calc = New VbaTypedComSample.Calculator
    Debug.Print calc.Divide(10, 0)
    Exit Sub
EH:
    Debug.Print Err.Number, Err.Description
End Sub

配布時に必要なファイル

VbaTypedComSample.dll
VbaTypedComSample.comhost.dll
VbaTypedComSample.deps.json
VbaTypedComSample.runtimeconfig.json
VbaTypedComSample.tlb

さらに、クライアント PC には対応する .NET 8 ランタイム が必要。

はまりどころ

1. AnyCPU のまま放置しない: 64bit Office なら x64、32bit Office なら x86
2. ClassInterfaceType.AutoDual を使わない: 公開後のメンバー順変更で壊れやすい
3. GUID を軽率に再生成しない: COM では GUID が契約そのもの。変更すると既存参照が壊れる
4. 公開済みインターフェイスを壊さない: 変更が大きいなら ICalculator2 を新設する
5. 型は地味に寄せる: VBA 境界では int、double、bool、string、DateTime、decimal、enum が安全
6. Office を開いたまま更新しない: DLL が掴まれたままになりビルドや再登録でトラブルに

まとめ

.NET 8 × VBA 連携は COM host と TLB を分けて考える のがコツ。

• 起動入口: *.comhost.dll
• 型情報: *.tlb
• 実装本体: *.dll

この構成で EnableComHosting=true → dscom tlbexport → regsvr32 + dscom tlbregister → VBA 参照設定の流れを押さえれば、型付きで安全に連携できる。

参考資料

• Expose .NET components to COM - Microsoft Learn
• COM 相互運用のために .NET 型を修飾する - Microsoft Learn
• ComInterfaceType 列挙型 - Microsoft Learn
• ClassInterfaceType 列挙型 - Microsoft Learn
• COM 呼び出し可能ラッパー - Microsoft Learn
• DispIdAttribute クラス - Microsoft Learn
• dscom - NuGet Gallery
• How to use the Regsvr32 tool and troubleshoot Regsvr32 error messages - Microsoft Support
• .NET 8 downloads