大网数据广告活动
.NET 与 C# 开发

Regasm.exe(程序集注册工具)

· 52CE 我爱测

程序集注册工具读取程序集中的元数据,并将所需项添加到注册表中。注册表允许 COM 客户端以透明方式创建 .NET Framework 类。 在注册一个类之后,任何 COM 客户端都可以像使用 COM 类一样使用它。 类仅在安装程序集时注册一次。 只有实际注册程序集中的类实例之后才能从 COM 中创建它们。

程序集注册工具读取程序集中的元数据,并将所需项添加到注册表中。注册表允许 COM 客户端以透明方式创建 .NET Framework 类。 在注册一个类之后,任何 COM 客户端都可以像使用 COM 类一样使用它。 类仅在安装程序集时注册一次。 只有实际注册程序集中的类实例之后才能从 COM 中创建它们。

要运行该工具,请使用 Visual Studio 开发人员命令提示。 有关详细信息,请参阅命令提示。

在命令提示符处,键入以下内容:

语法

regasm assemblyFile [options]

参数

参数 说明
assemblyFile 要向 COM 注册的程序集。
选项 说明
/codebase 在注册表中创建一个 Codebase 项。 Codebase 项指定未安装到全局程序集缓存中的程序集的文件路径。 如果随后将安装要注册到全局程序集缓存中的程序集,则不应指定此选项。 用 /codebase 选项指定的 assemblyFile 参数必须是具有强名称的程序集。
/registered 指定此工具将仅引用已经注册的类型库。
/asmpath:directory 指定包含程序集引用的目录。 必须与 /regfile 选项一起使用。
/nologo 取消显示 Microsoft 启动版权标志。
/regfile [: regFile] 为程序集生成指定的 .reg 文件,其中包含所需的注册表项。 指定此选项将不会更改注册表。 此选项不能与 /u 或 /tlb 选项一起使用。
/silent 或 /s 取消显示成功消息。
/tlb [: typeLibFile] 从指定的程序集生成类型库,该类型库包含在程序集中定义的可访问类型的定义。
/unregister 或 /u 注销在 assemblyFile 中找到的可创建类。 省略此选项将使 Regasm.exe 注册程序集中的可创建类。
/verbose 指定详细模式;当与 /tlb 选项一起指定时,将显示所有需要为其生成类型库的引用程序集的列表。
/? 或 /help 显示该工具的命令语法和选项。

Note: Regasm.exe 命令行选不区分大小写。 只需提供足以唯一地进行标识的选项部分。 例如,/n 等效于 /nologo,而 /t: outfile.tlb 等效于 /tlb: outfile.tlb。

备注

可以使用 /regfile 选项生成包含注册表项的 .reg 文件,而不是直接对注册表进行更改。 通过注册表编辑器工具 (Regedit.exe) 导入 .reg 文件,可以在计算机上更新注册表。 请注意,.reg 文件不包含任何可由用户定义的注册函数完成的注册表更新。 注意,/regfile 选项只为托管类发出注册表项。 此选项不为 TypeLibID 或 InterfaceID 发出注册表项。

指定 /tlb 选项时,Regasm.exe 将生成并注册一个类型库,对在程序集中找到的类型进行描述。 Regasm.exe 将生成的类型库放置在当前的工作目录中或为输出文件指定的目录中。 为引用其他程序集的程序集生成类型库可能导致同时生成几个类型库。 你可使用类型库向开发工具(如 Visual Studio)提供类型信息。 如果所注册的程序集是由类型库导入程序 (Tlbimp.exe) 生成的,则不应使用 /tlb 选项。 如果程序集是从类型库导入的,则不能从它导出类型库。 除了类型库导出程序 (Tlbexp.exe) 不会注册其生成的类型库外,使用 /tlb 选项与使用 Tlbexp.exe 和 Regasm.exe 的效果相同。 如果使用 /tlb 选项注册某个类型库,则可将 /tlb 选项和 /unregister 选项一起使用以注销类型库。 将两个选项一起使用将注销类型库和接口项,这样可较大程度地清理注册表。

当你注册一个程序集供 COM 使用时,Regasm.exe 会在本地计算机上的注册表中添加一些项。 具体而言,它将创建一些与版本相关的注册表键,从而允许在一台计算机上并行运行同一程序集的多个版本。 在第一次注册某个程序集时,将会为该程序集创建一个顶级键,并为特定版本创建一个唯一的子键。 每次注册该程序集的新版本时,Regasm.exe 都将为新版本创建一个子键。

例如,假设你注册了一个版本为 1.0.0.0 的托管组件 myComp.dll 供 COM 使用。 之后,你注册了版本为 2.0.0.0 的 myComp.dll。 你确定计算机上的所有 COM 客户端应用程序都要使用 2.0.0.0 版本的 myComp.dll,并且决定注销 myComponent.dll 版本 1.0.0.0。 此注册表方案允许你注销 myComp.dll 版本 1.0.0.0,这是因为注销操作只移除 1.0.0.0 版本子键。

使用 Regasm.exe 注册一个程序集之后,可以将该程序集安装在全局程序集缓存中,以便可以从任何 COM 客户端激活它。 如果该程序集将仅由单个应用程序激活,则可以将其放置在该应用程序的目录中。

示例

下面的命令将注册 myTest.dll 中包含的所有公共类。

regasm myTest.dll

下面的命令生成包含所有必要的注册表项的 myTest.reg 文件。 此命令不更新注册表。

regasm myTest.dll /regfile:myTest.reg

下面的命令注册 myTest.dll 中包含的所有公共类,并生成和注册类型库 myTest.tlb,该类型库包含 myTest.dll 中定义的所有公共类型的定义。

regasm myTest.dll /tlb:myTest.tlb

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpetrusha)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。