Regasm.exe（程序集注册工具）

更新：2011 年 4 月

程序集注册工具读取程序集中的元数据，并将所需的项添加到注册表中。注册表允许 COM 客户程序以透明方式创建 .NET Framework 类。 类一经注册，任何 COM 客户程序都可以使用它，就好像该类是一个 COM 类。 类仅在安装程序集时注册一次。 程序集中的类实例直到被实际注册时，才能从 COM 中创建。

安装 Visual Studio 和 Windows SDK 时会自动安装此工具。 要运行工具，我们建议您使用 Visual Studio 命令提示符或 Windows SDK 命令提示符（也称 CMD Shell）。 您可以使用这些实用程序轻松运行工具，而不需要导航到安装文件夹。 有关更多信息，请参见 Visual Studio 和 Windows SDK 命令提示。

• 如果您的计算机上已安装了 Visual Studio：在任务栏上依次单击 Start、All Programs、Visual Studio、Visual Studio Tools、Visual Studio Command Prompt。

  - 或 -

  如果您的计算机上已安装了 Windows SDK：在任务栏上依次单击 Start、All Programs、Windows SDK 文件夹和 Command Prompt（或CMD Shell)。

• 在命令提示处，键入下列命令：

regasm assemblyFile [options]

参数

Parameter	说明
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	显示该工具的命令语法和选项。

注意
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 2005）提供类型信息。 如果正在注册的程序集是由类型库导入程序 (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

请参见

参考

Tlbexp.exe（类型库导出程序）

Tlbimp.exe（类型库导入程序）

Visual Studio 和 Windows SDK 命令提示

概念

向 COM 注册程序集

其他资源

.NET Framework 工具

修订记录

Date	修订记录	原因
2011 年 4 月	添加了有关使用 Visual Studio 和 Windows SDK 命令提示符的信息。	信息补充。