ResolveComReference 任务
获取一个或多个类型库名称或 .tlb 文件的列表，将这些类型库解析为磁盘上的位置。
参数
下表描述了 ResolveCOMReference 任务的参数。
| 参数 | 说明 |
|---|---|
DelaySign |
可选 Boolean 参数。如果为 true，任务会在程序集中放入公钥。 如果为 false，任务会对程序集进行完全签名。 |
EnvironmentVariables |
可选 String[] 参数。环境变量对的数组（使用等号分隔）。 这些变量会传递给生成的 tlbimp.exe 和 aximp.exe 以及常规环境块，或有选择地重写常规环境块。 |
ExecuteAsTool |
可选 Boolean 参数。如果为 true，请于进程外从适当的目标框架运行 tlbimp.exe 和 aximp.exe 来生成所需的包装器程序集。 此参数支持多目标。 |
IncludeVersionInInteropName |
可选 Boolean 参数。如果为 true，包装器名称中将包含 TypeLib 版本。 默认值为 false。 |
KeyContainer |
可选 String 参数。指定保存公钥/私钥对的容器。 |
KeyFile |
可选 String 参数。指定包含公钥/私钥对的项。 |
NoClassMembers |
可选 Boolean 参数。 |
ResolvedAssemblyReferences |
可选的 ITaskItem[] 输出参数。指定已解析的程序集引用。 |
ResolvedFiles |
可选的 ITaskItem[] 输出参数。指定磁盘上的完全限定文件，这些文件与作为此任务的输入提供的类型库的物理位置相对应。 |
ResolvedModules |
可选 ITaskItem[] 参数。 |
SdkToolsPath |
可选 System.String 参数。 如果 ExecuteAsTool 为 true，则必须将此参数设置为作为目标的框架版本的 SDK 工具路径。 |
StateFile |
可选 String 参数。指定 COM 组件时间戳的缓存文件。 如果不存在，则每次运行将重新生成所有包装器。 |
TargetFrameworkVersion |
可选 String 参数。指定项目目标框架版本。 默认值为 String.Empty。 这意味着没有基于目标框架的引用的筛选。 |
TargetProcessorArchitecture |
可选 String 参数。指定首选的目标处理器体系结构。 转换后传递给 tlbimp.exe/machine 标志。 参数值应属于 ProcessorArchitecture。 |
TypeLibFiles |
可选 ITaskItem[] 参数。指定 COM 引用的类型库文件路径。 此参数中包含的项可能包含项元数据。 有关详细信息，请参阅下面的 TypeLibFiles 项元数据部分。 |
TypeLibNames |
可选 ITaskItem[] 参数。指定要解析的类型库名称。 此参数中包含的项必须包含一些项元数据。 有关详细信息，请参阅下面的 TypeLibNames 项元数据部分。 |
WrapperOutputDirectory |
可选 String 参数。生成的互操作程序集放置在磁盘上的位置。 如果未指定此项元数据，任务将使用项目文件所在目录的绝对路径。 |
TypeLibNames 项元数据
下表介绍了传递给 TypeLibNames 参数的项可用的项元数据。
| 元数据 | 描述 |
|---|---|
GUID |
所需的项元数据。 类型库的 GUID。 如果未指定此项元数据，则任务失败。 |
VersionMajor |
所需的项元数据。 类型库的主版本。 如果未指定此项元数据，则任务失败。 |
VersionMinor |
所需的项元数据。 类型库的次版本。 如果未指定此项元数据，则任务失败。 |
EmbedInteropTypes |
可选的 Boolean 元数据。如果为 true，则将此引用中的互操作类型直接嵌入到程序集中，而不是生成互操作 DLL。 |
LocaleIdentifier |
可选项元数据。 类型库的区域设置标识符（或 LCID）。 被指定为 32 位值，可标识用户、区域或应用程序首选的人类语言。 如果未指定此项元数据，任务将使用默认区域设置标识符“0”。 |
WrapperTool |
可选项元数据。 指定用于生成此类型库的程序集包装器的包装工具。 如果未指定此项元数据，任务将使用默认包装工具“tlbimp”。 可供类型库使用且区分大小写的选项有： - Primary：如果希望使用已为 COM 组件生成的主互操作程序集，请使用此包装工具。 使用此包装工具时，请勿指定包装器输出目录，否则任务会失败。- TLBImp：如果希望为 COM 组件生成互操作程序集，请使用此包装工具。- PrimaryOrTLBImp：如果不确定 Primary 或 TLBImp 是否合适，则使用此包装器工具。 首先应用 Primary 逻辑，然后应用 TLBImp。- AXImp：如果希望为 ActiveX 控件生成互操作程序集，请使用此包装工具。 |
TypeLibFiles 项元数据
下表介绍了传递给 TypeLibFiles 参数的项可用的项元数据。
| 元数据 | 描述 |
|---|---|
EmbedInteropTypes |
可选 Boolean 参数。如果为 true，则将此引用中的互操作类型直接嵌入到程序集中，而不是生成互操作 DLL。 |
WrapperTool |
可选项元数据。 指定用于生成此类型库的程序集包装器的包装工具。 如果未指定此项元数据，任务将使用默认包装工具“tlbimp”。 可供类型库使用且区分大小写的选项有： - Primary：如果希望使用已为 COM 组件生成的主互操作程序集，请使用此包装工具。 使用此包装工具时，请勿指定包装器输出目录，否则任务会失败。- TLBImp：如果希望为 COM 组件生成互操作程序集，请使用此包装工具。- AXImp：如果希望为 ActiveX 控件生成互操作程序集，请使用此包装工具。 |
注意
为类型库提供的唯一标识符信息越多，任务能解析磁盘上正确文件的可能性就越大。
备注
除上面列出的参数外，此任务还从 Task 类继承参数。 有关这些其他参数的列表及其说明，请参阅任务基类。
不需要在计算机上注册 COM DLL 来使此任务正常工作。
MSB4803 错误
如果尝试通过 dotnet CLI 命令运行使用 ResolveCOMReference 任务的项目，则会收到以下错误：
MSB4803: The task "ResolveComReference" is not supported on the .NET Core version of MSBuild. Please use the .NET Framework version of MSBuild.
此任务在 MSBuild 的 .NET Core 版本上不受支持，它是从命令行运行 dotnet build 命令时使用的。 尝试通过从 Visual Studio 开发人员命令提示调用 Msbuild.exe 来生成项目，因为这将使用 MSBuild 的 .NET Framework 版本。