为何C# COM可见DLL在Excel VBA中始终返回#VALUE!？

我正在开发一个需设为COM可见的C# DLL，主要用于嵌入Microsoft Excel VBA。开发时使用Visual Studio的「Register for COM Interop」复选框自动注册，在本地电脑的Excel中可正常获取输出，但手动在客户端机器注册后，调用时Excel仅返回#VALUE!。

我的操作流程如下：

AssemblyInfo.cs #

[assembly: ComVisible(true)]

Class1.cs #

namespace ManualRegister
{
    public class Class1
    {
        public string test()
        {
            return "Working!";
        }
    }
}

• 将ManualRegister.dll复制到SysWOW64目录

Register.bat #

cd/
C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe ManualRegister.dll /tlb:ManualRegister.tlb /codebase
pause

VBA代码 #

在VBA模块中添加引用后，编写代码：

Function test()
    Dim object As New ManualRegister.Class1
    test = object.test()
End Function

出现VBA错误，我也尝试过特定CPU架构编译，但问题仍未解决。请问我遗漏了哪一步或操作有误？

以下是几个最可能导致问题的原因及对应解决方法：

1. Excel与RegAsm/DLL的架构不匹配 #

这是最常见的问题，Excel的位数（32/64位）必须和你使用的RegAsm版本、DLL编译架构完全一致：

• 检查Excel位数：打开Excel → 文件 → 账户 → 关于Excel，查看是32位还是64位。
• 匹配RegAsm版本：
  • 32位Excel：必须使用32位RegAsm，路径为C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe，DLL编译为x86或Any CPU（在32位环境下会自动以32位运行）。
  • 64位Excel：必须使用64位RegAsm，路径为C:\Windows\Microsoft.NET\Framework64\v4.0.30319\RegAsm.exe，DLL编译为x64或Any CPU。
• 注意：SysWOW64是32位程序的系统目录，如果你用64位Excel，DLL可以放在System32或自定义目录，但要确保RegAsm路径正确。

2. 程序集未做强名称签名 #

使用/codebase参数注册COM组件时，要求程序集必须有强名称签名，否则注册表写入会无效（可能静默失败）：

• 解决步骤：
  1. 在Visual Studio中右键项目 → 属性 → 签名 → 勾选「为程序集签名」。
  2. 在「选择强名称密钥文件」下拉框中选「新建」，创建一个.pfx密钥文件（可设置密码或留空）。
  3. 重新编译DLL，再复制到客户端机器执行注册。

3. 注册时未使用管理员权限 #

RegAsm需要写入系统级注册表，必须以管理员身份运行批处理文件：

• 右键点击Register.bat → 选择「以管理员身份运行」，否则注册操作会因权限不足失败，导致VBA无法找到组件。

4. 缺少显式COM接口定义 #

虽然全局设置了ComVisible(true)，但显式定义COM接口并让类实现它，能避免VBA交互时的兼容性问题：
修改Class1.cs代码如下（记得生成唯一GUID）：

namespace ManualRegister
{
    [ComVisible(true)]
    [Guid("F5A5B6C7-1234-5678-90AB-CDEF01234567")] // 生成唯一GUID：VS工具→创建GUID→选格式4
    public interface IClass1
    {
        string test();
    }

    [ComVisible(true)]
    [Guid("12345678-ABCD-EFGH-IJKL-MNOPQRSTUVWX")] // 另一个唯一GUID
    [ClassInterface(ClassInterfaceType.None)] // 禁用自动生成的类接口
    public class Class1 : IClass1
    {
        public string test()
        {
            return "Working!";
        }
    }
}

• 生成GUID的方法：Visual Studio顶部菜单 → 工具 → 创建GUID → 选择「Registry Format」（格式4），复制字符串替换上面的示例GUID。

5. 验证注册表条目是否正确 #

注册完成后，可通过注册表编辑器确认组件是否正确注册：

1. 打开regedit，搜索HKEY_CLASSES_ROOT\ManualRegister.Class1，找到对应的CLSID值。
2. 搜索HKEY_CLASSES_ROOT\CLSID\{刚才的CLSID值}\InprocServer32：
   • 确认默认值为对应位数的mscoree.dll（32位是C:\Windows\SysWOW64\mscoree.dll，64位是C:\Windows\System32\mscoree.dll）。
   • 确认CodeBase值指向你的DLL的完整路径，且路径正确无误。

内容的提问来源于stack exchange，提问作者Eog