萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

.NET 2.0 開發 COM 組件供 VB6/VBA 調用完整指南

概述

.NET 組件默認不對 COM 可見。通過定義接口、實現類、註冊類型庫、加入 GAC 等步驟,可將 .NET 2.0 組件暴露為標準 COM 組件,供 VB6、VBA、VBScript、ASP 等非托管代碼調用。

步驟 1:定義 COM 可見接口

using System.Runtime.InteropServices;

[Guid("0BB13346-7E9D-4ABA-9FF2-862E0105489A")]
[InterfaceType(ComInterfaceType.InterfaceIsDual)] // 支持早綁定/晚綁定
public interface IMyService
{
    [DispId(1)]
    void Method1(string args);

    [DispId(2)]
    int Add(int a, int b);
}
  • Guid:接口唯一標識,必須固定,切勿隨機生成後再變更。
  • InterfaceIsDual:同時支持 IDispatch(晚綁定)和 vtable(早綁定),兼容性最好。
  • DispId:手動指定調度 ID,保證版本兼容,避免重編譯導致 ID 變化。

步驟 2:實現接口類

[Guid("BA0A3019-F0D8-4406-8116-F80D5515C686")]
[ProgId("ClassNamespace.MyService")]          // VB 中 CreateObject 使用的名稱
[ClassInterface(ClassInterfaceType.None)]     // 不自動生成類接口,強制通過 IMyService 訪問
[ComVisible(true)]
public class MyService : IMyService
{
    public void Method1(string args)
    {
        // 實現邏輯
        System.Windows.Forms.MessageBox.Show("Hello from .NET: " + args);
    }

    public int Add(int a, int b)
    {
        return a + b;
    }
}
  • ClassInterfaceType.None:防止 .NET 自動生成 _MyService 接口,避免版本衝突。
  • ProgId:人類可讀的程序標識,VB 中用 CreateObject("ClassNamespace.MyService")。

步驟 3:組件簽名與註冊

3.1 創建強名稱密鑰

sn -k MyKey.snk

將 MyKey.snk 複製到專案目錄。

3.2 關聯強名稱

在 AssemblyInfo.cs 中添加:

[assembly: AssemblyKeyFile(@"..\..\MyKey.snk")]

3.3 設置 COM 可見性

[assembly: ComVisible(true)]                       // 整個程序集對 COM 可見
[assembly: Guid("E011ED16-93A3-41AA-8375-399FA259B935")] // 類型庫 GUID

3.4 導出類型庫 (.tlb)

tlbexp MyAssembly.dll /out:MyAssembly.tlb

生成的 .tlb 供 VB6 早綁定引用(項目 → 引用 → 瀏覽選中 .tlb)。

3.5 註冊組件

# 管理員權限 CMD
regasm MyAssembly.dll /tlb:MyAssembly.tlb /codebase
  • /codebase:在註冊表中記錄程序集路徑,允許不在 GAC 中的組件被調用(開發調試階段推薦)。
  • 生產環境建議加入 GAC,則不需 /codebase。

3.6 加入全局程序集緩存 (GAC)

gacutil -i MyAssembly.dll

驗證:gacutil -l | find "MyAssembly"。

步驟 4:VB6/VBA 中調用

早綁定(推薦,有智能提示)

  1. VB6 IDE:項目 → 引用 → 瀏覽選中 MyAssembly.tlb。
  2. 代碼:
    Dim obj As New ClassNamespace.MyService
    obj.Method1("測試參數")
    MsgBox obj.Add(10, 20)
    

晚綁定(無需引用,部署靈活)

Dim obj As Object
Set obj = CreateObject("ClassNamespace.MyService")
obj.Method1 "測試參數"
MsgBox obj.Add(10, 20)

常見問題排查

現象原因解決
「ActiveX 組件不能創建對象」組件未註冊/註冊失敗管理員運行 regasm /codebase;檢查 GAC;確認目標平台 x86/x64 一致
方法調用報「類型不匹配」參數封送失敗接口參數使用基本類型;數組用 ref object 或 Array;避免泛型、委托
VB6 報「無法加載類型庫」.tlb 未註冊或路徑錯誤regasm /tlb 重新導出並註冊
64 位 Office/系統調用失敗組件編譯為 x86,進程為 64 位專案屬性 → Build → 取消勾選「Prefer 32-bit」或顯式編譯為 x64;或在 32 位進程中運行(如 SysWOW64\cscript.exe)

部署清單

  • MyAssembly.dll、MyAssembly.tlb、MyKey.snk
  • 目標機安裝 .NET Framework 2.0+(含 Client Profile)。
  • 管理員運行安裝腳本:regasm.dll /codebase & gacutil -i。
copyright © 萬盛學電腦網 all rights reserved