Share via


ResolveComReference 任务

更新:2007 年 11 月

获取一个或多个类型库名称或 .tlb 文件的列表,将这些类型库解析为磁盘上的位置。

参数

下表描述了 ResolveCOMReference 任务的参数。

参数

说明

DelaySign

可选的 Boolean 参数。

如果为 true,则将公钥放入程序集中。如果为 false,则对程序集进行完全签名。

KeyContainer

可选的 String 参数。

指定保存密钥对的容器。

KeyFile

可选的 String 参数。

指定包含密钥对的项。

NoClassMembers

可选的 Boolean 参数。

ResolvedAssemblyReferences

可选的 ITaskItem[] 输出参数。

指定已解析的程序集引用。

ResolvedFiles

可选的 ITaskItem[] 输出参数。

指定磁盘上与类型库(作为此任务的输入提供)的物理位置对应的完全限定文件。

ResolvedModules

可选的 ITaskItem[] 参数。

TypeLibFiles

可选的 ITaskItem[] 参数。

指定指向 COM 引用的类型库文件路径。此参数中包括的项可能包含项元数据。有关更多信息,请参见下面的“TypeLibFiles 项元数据”部分。

TypeLibNames

可选的 ITaskItem[] 参数。

指定要解析的类型库名称。此参数中包括的项必须包含某些项元数据。有关更多信息,请参见下面的“TypeLibNames 项元数据”部分。

WrapperOutputDirectory

可选的 String 参数。

生成的互操作程序集放置在磁盘上的位置。如果未指定此项元数据,任务将使用项目文件所在目录的绝对路径。

备注

TypeLibNames 项元数据

下表描述可供传递给 TypeLibNames 参数的项使用的项元数据。

元数据

说明

GUID

必选的项元数据。

类型库的 GUID。如果未指定此项元数据,任务将失败。

VersionMajor

必选的项元数据。

类型库的主版本。如果未指定此项元数据,任务将失败。

VersionMinor

必选的项元数据。

类型库的次版本。如果未指定此项元数据,任务将失败。

LocaleIdentifier

可选的项元数据。

类型库的区域设置标识符(或 LCID)。这是作为一个 32 位值指定的,它标识用户、区域或应用程序首选的人类语言。如果未指定此项元数据,任务将使用默认的区域设置标识符“0”。

WrapperTool

可选的项元数据。

指定用来生成此类型库的程序集包装的包装工具。如果未指定此项元数据,任务将使用默认的包装工具“tlbimp”。类型库可用的、不区分大小写的选项为:

  • Primary:当您想要为 COM 组件使用已生成的主互操作程序集时,请使用此包装工具。使用此包装工具时,请不要指定包装输出目录,因为这将导致任务失败。

  • TLBImp:当您想要为 COM 组件生成一个互操作程序集时,请使用此包装工具。

  • AXImp:当您想要为 ActiveX 组件生成一个互操作程序集时,请使用此包装工具。

TypeLibFiles 项元数据

下表描述可供传递给 TypeLibFiles 参数的项使用的项元数据。

元数据

说明

WrapperTool

可选的项元数据。

指定用来生成此类型库的程序集包装的包装工具。如果未指定此项元数据,任务将使用默认的包装工具“tlbimp”。类型库可用的、不区分大小写的选项为:

  • Primary:当您想要为 COM 组件使用已生成的主互操作程序集时,请使用此包装工具。使用此包装工具时,请不要指定包装输出目录,因为这将导致任务失败。

  • TLBImp:当您想要为 COM 组件生成一个互操作程序集时,请使用此包装工具。

  • AXImp:当您想要为 ActiveX 组件生成一个互操作程序集时,请使用此包装工具。

说明:

提供的可唯一地标识类型库的信息越多,任务解析出磁盘上的正确文件的可能性就越大。

请参见

概念

MSBuild 任务

其他资源

MSBuild 任务参考