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

将类型库当作程序集导入

· 52CE 我爱测

COM 类型定义通常位于类型库中。 而符合 CLS 的编译器则在程序集中生成类型元数据。 类型信息的这两种来源具有很大的区别。 本主题将说明从类型库中生成元数据的技术。 生成的程序集称为互操作程序集,其中包含的类型信息允许 .NET Framework 应用程序使用 COM 类型。

COM 类型定义通常位于类型库中。 而符合 CLS 的编译器则在程序集中生成类型元数据。 类型信息的这两种来源具有很大的区别。 本主题将说明从类型库中生成元数据的技术。 生成的程序集称为互操作程序集,其中包含的类型信息允许 .NET Framework 应用程序使用 COM 类型。

可通过两种方式将此类型信息提供给应用程序:

  • 使用仅设计时互操作程序集:从 .NET Framework 4 开始,可以指示编译器将类型信息从互操作程序集嵌入到可执行文件中。 编译器只嵌入应用程序使用的类型信息。 无需将互操作程序集与应用程序一起部署。 这是推荐采用的方法。

  • 部署互操作程序集:创建对互操作程序集的标准引用。 这种情况下,互操作程序集必须与应用程序一起部署。 如果使用此方法且不使用专有 COM 组件,请始终引用由打算并入托管代码中的 COM 组件的创建者发布的主互操作程序集 (PIA)。 有关生成和使用主互操作程序集的详细信息,请参阅主互操作程序集。

使用仅设计时互操作程序集时,可以嵌入 COM 组件创建者发布的主互操作程序集中的类型信息。 但是,无需将主互操作程序集与应用程序一起部署。

使用仅设计时互操作程序集可以缩减应用程序的大小,因为大部分应用程序不会用到 COM 组件的所有功能。 编译器在嵌入类型信息时效率非常高,如果应用程序只使用 COM 接口上的部分方法,则编译器不嵌入未使用的方法。 具有嵌入的类型信息的应用程序与另一个此类应用程序交互时,或者与一个使用主互操作程序集的应用程序交互时,公共语言运行时使用类型等效规则来确定同名的两个类型是否表示相同的 COM 类型。 使用 COM 对象不需要知道这些规则。 但是,若对这些规则感兴趣,请参阅类型等效性和嵌入的互操作类型。

生成元数据

COM 类型库可以是扩展名名 .tlb 的独立文件,例如 Loanlib.tlb。 部分类型库嵌入在 .dll 或 .exe 文件的资源部分中。 类型库信息的其它来源为 .olb 和 .ocx 文件。

找到包含目标 COM 类型的实现的类型库后,可以通过下列选项来生成包含类型元数据的互操作程序集:

  • Visual Studio

    Visual Studio 将类型库中的 COM 类型自动转换为程序集中的元数据。 有关说明,请参阅如何:添加对类型库的引用中所述。

  • 类型库导入程序 (Tlbimp.exe)

    类型库导入程序提供命令行选项,用于调整生成的互操作文件中的元数据、从现有类型库导入类型以及生成互操作程序和命名空间。 有关说明,请参阅如何:从类型库生成互操作程序集。

  • xref:System.Runtime.InteropServices.TypeLibConverter?displayProperty=nameWithType 类

    此类提供将类型库中的组件类和接口转换为程序集中的元数据的方法。 它生成和 Tlbimp.exe 相同的元数据输出。 但与 Tlbimp.exe 不同的是,xref:System.Runtime.InteropServices.TypeLibConverter 类可以将内存中类型库转换为元数据。

  • 自定义包装器

    类型库不可用或不正确时,一种可选的做法是在托管源代码中创建类或接口的重复定义。 然后,使用面向运行时的编译器来编译源代码,生成程序集中的元数据。

    要手动定义 COM 类型,必须具有对以下项的访问权限:

    • 所定义的组件类和接口的精确描述。

    • 可生成正确 .NET Framework 类定义的编译器,例如 C# 编译器。

    • 有关类型库到程序集转换规则的知识。

    编写自定义包装器是一项高级技术。 有关如何生成自定义包装器的其他信息,请参阅自定义标准包装器。

有关 COM 互操作导入过程的详细信息,请参阅有关从类型库转换到程序集的摘要。

请参阅

历史资料。此文对应 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(示例代码)

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

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