ResolveComReference 类

定义

适用于 .NET Core 的 COM 引用解析任务的主类Main class for the COM reference resolution task for .NET Core

此 API 支持产品基础结构,不能在代码中直接使用。

public ref class ResolveComReference sealed : Microsoft::Build::Tasks::AppDomainIsolatedTaskExtension
public ref class ResolveComReference sealed : Microsoft::Build::Tasks::TaskExtension
public sealed class ResolveComReference : Microsoft.Build.Tasks.AppDomainIsolatedTaskExtension
public sealed class ResolveComReference : Microsoft.Build.Tasks.TaskExtension
type ResolveComReference = class
    inherit AppDomainIsolatedTaskExtension
type ResolveComReference = class
    inherit TaskExtension
Public NotInheritable Class ResolveComReference
Inherits AppDomainIsolatedTaskExtension
Public NotInheritable Class ResolveComReference
Inherits TaskExtension
继承
继承
ResolveComReference

注解

在64位计算机上,Framework64/ <version> /msbuild 无法解析注册为32位组件的 COM 对象。On a 64-bit machine, Framework64/<version>/msbuild cannot resolve COM objects registered as 32-bit components. 例如,如果向 regsvr32 注册 COM 对象,然后尝试使用 Framework64//msbuild 生成面向 x86 平台的项目 <version> ,则生成将无法解析 COM 对象。For example, if you register a COM object with regsvr32 and then try to build a project targeting the x86 platform with Framework64/<version>/msbuild, the build is unable to resolve the COM object. 如果是用 Framework//msbuild 生成的 <version> ,则生成能够解析 COM 对象。If instead you build with Framework/<version>/msbuild, the build is able to resolve the COM object.

构造函数

ResolveComReference()

此 API 支持产品基础结构,不能在代码中直接使用。

初始化 ResolveComReference 类的新实例。Initializes a new instance of the ResolveComReference class.

属性

BuildEngine

生成引擎自动设置此属性,以允许任务回调到其中。The build engine automatically sets this property to allow tasks to call back into it.

(继承自 AppDomainIsolatedTask)
BuildEngine

生成引擎自动设置此属性,以允许任务回调到其中。The build engine automatically sets this property to allow tasks to call back into it.

(继承自 Task)
BuildEngine2

生成引擎自动设置此属性,以允许任务回调到其中。The build engine automatically sets this property to allow tasks to call back into it. 这是一个便捷属性,因此从此类继承的任务作者不必将值从 IBuildEngine 强制转换为 IBuildEngine2。This is a convenience property so that task authors inheriting from this class do not have to cast the value from IBuildEngine to IBuildEngine2.

(继承自 Task)
BuildEngine3

检索主机提供的生成引擎接口的 IBuildEngine3 版本。Retrieves the IBuildEngine3 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine4

检索主机提供的生成引擎接口的 IBuildEngine4 版本。Retrieves the IBuildEngine4 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine5

检索主机提供的生成引擎接口的 IBuildEngine5 版本。Retrieves the IBuildEngine5 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine6

检索主机提供的生成引擎接口的 IBuildEngine6 版本。Retrieves the IBuildEngine6 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine7

获取主机提供的生成引擎接口的版本。Gets the version of the build engine interface provided by the host.

(继承自 Task)
DelaySign

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置一个布尔值,该值指定 ResolveComReference 任务是在程序集中放置公钥 (true),还是对程序集进行完全签名 (false)。Gets or sets a Boolean value that specifies whether the ResolveComReference task places the public key in the assembly (true) or fully signs the assembly (false).

EnvironmentVariables

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置除了(或者有选择地重写)常规的环境块之外,应传递到生成的 tlbimp.exe 和 aximp.exe 的环境变量名称-值对的数组。Gets or sets an array of name-value pairs of environment variables that should be passed to the spawned tlbimp.exe and aximp.exe in addition to (or selectively overriding) the regular environment block.

ExecuteAsTool

此 API 支持产品基础结构,不能在代码中直接使用。

允许 ResolveComReferences 的多目标功能的属性:如果为 true,则来自适当的目标框架的 tlbimp.exe 和 aximp.exe 将在进程外运行以生成必要的包装程序集。Property to allow multitargeting of ResolveComReferences: If true, tlbimp.exe and aximp.exe from the appropriate target framework will be run out-of-proc to generate the necessary wrapper assemblies.

HelpKeywordPrefix

获取或设置前缀,该前缀用于通过字符串资源名称组成 help 关键字。Gets or sets the prefix used to compose help keywords from string resource names. 如果任务没有与消息关联的 help 关键字,则可以忽略此属性或将其设置为 null。If a task does not have help keywords associated with its messages, it can ignore this property or set it to null. 如果前缀设置为空字符串,则字符串资源名称将逐字用作 help 关键字。If the prefix is set to an empty string, then string resource names will be used verbatim as help keywords. 有关如何使用此前缀的示例,请参见 LogErrorWithCodeFromResources(String, Object[]) 方法。For an example of how this prefix is used, see the LogErrorWithCodeFromResources(String, Object[]) method.

(继承自 AppDomainIsolatedTask)
HelpKeywordPrefix

获取或设置前缀,该前缀用于通过字符串资源名称组成 help 关键字。Gets or sets the prefix used to compose help keywords from string resource names. 如果任务没有与消息关联的 help 关键字,则可以忽略此属性或将其设置为 null。If a task does not have help keywords associated with its messages, it can ignore this property or set it to null. 如果前缀设置为空字符串,则字符串资源名称将逐字用作 help 关键字。If the prefix is set to an empty string, then string resource names will be used verbatim as help keywords. 有关如何使用此前缀的示例,请参阅 TaskLoggingHelper.LogErrorWithCodeFromResources(string, object[]) 方法。For an example of how this prefix is used, see the TaskLoggingHelper.LogErrorWithCodeFromResources(string, object[]) method.

(继承自 Task)
HostObject

如果主机 IDE 具有与此特定任务关联的主机对象,则生成引擎会设置此属性。The build engine sets this property if the host IDE has associated a host object with this particular task.

(继承自 AppDomainIsolatedTask)
HostObject

如果主机 IDE 具有与此特定任务关联的主机对象,则生成引擎会设置此属性。The build engine sets this property if the host IDE has associated a host object with this particular task.

(继承自 Task)
IncludeVersionInInteropName

此 API 支持产品基础结构,不能在代码中直接使用。

若设置为 true,则 typelib 版本将包含在包装名称中。When set to true, the typelib version will be included in the wrapper name. 默认值为 false。Default is false.

KeyContainer

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置保存密钥对的容器。Gets or sets a container that holds a key pair.

KeyFile

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置包含密钥对的项。Gets or sets an item that contains a key pair.

Log

此 API 支持产品基础结构,不能在代码中直接使用。

获取包含任务日志记录方法的 TaskLoggingHelperExtension 类的实例。Gets an instance of a TaskLoggingHelperExtension class containing task logging methods.

(继承自 AppDomainIsolatedTaskExtension)
Log

此 API 支持产品基础结构,不能在代码中直接使用。

获取包含任务日志记录方法的 TaskLoggingHelperExtension 类的实例。Gets an instance of a TaskLoggingHelperExtension class containing task logging methods.

(继承自 TaskExtension)
NoClassMembers

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置一个布尔值,该值指定是否将 PreventClassMembers 标志传递给 .tlb 包装器生成。Gets or sets a Boolean value that specifies whether to pass the PreventClassMembers flag to .tlb wrapper generation.

ResolvedAssemblyReferences

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置已解析的程序集引用。Gets or sets the resolved assembly references.

ResolvedFiles

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置磁盘上的完全限定文件,这些文件与作为此任务的输入提供的类型库的物理位置相对应。Gets or sets the fully qualified files on disk that correspond to the physical locations of the type libraries that were provided as input to this task.

ResolvedModules

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置找到的模块的路径。Gets or sets the paths to the modules that were found.

SdkToolsPath

此 API 支持产品基础结构,不能在代码中直接使用。

如果 ExecuteAsTool 为 true,则必须将此项设置为目标框架版本的 SDK 工具路径。If ExecuteAsTool is true, this must be set to the SDK tools path for the framework version being targeted.

Silent

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置一个值,该值指示是否记录消息或警告。Gets or sets a value that indicates whether messages or warnings are logged.

StateFile

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置 COM 组件时间戳的缓存文件。Gets or sets the cache file for COM component timestamps.

TargetFrameworkVersion

此 API 支持产品基础结构,不能在代码中直接使用。

项目目标框架版本。The project target framework version. 默认为空,Default is empty. 这意味着不会基于引用的目标框架来对其进行筛选。which means there will be no filtering for the reference based on their target framework.

TargetProcessorArchitecture

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置转换之后传递到 tlbimp.exe/计算机标志的首选目标处理器架构名称,例如 x86、ia64、amd64 或 msil。Gets or sets the name of the preferred target processor architecture, which is passed to the tlbimp.exe /machine flag after translation, for example x86, ia64, amd64 or msil.

TaskResources

获取或设置任务的区域性特定资源。Gets or sets the task's culture-specific resources. 派生类应在构造期间注册资源,如果它们有本地化字符串,则可以通过此属性注册。Derived classes should register their resources either during construction, or via this property, if they have localized strings.

(继承自 AppDomainIsolatedTask)
TaskResources

获取或设置任务的区域性特定资源。Gets or sets the task's culture-specific resources. 派生类应在构造期间注册资源,如果它们有本地化字符串,则可以通过此属性注册。Derived classes should register their resources either during construction, or via this property, if they have localized strings.

(继承自 Task)
TypeLibFiles

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置到 COM 引用的类型库文件路径。Gets or sets the type library file path to COM references.

TypeLibNames

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置要解析的类型库名称。Gets or sets the type library names to resolve.

WrapperOutputDirectory

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置生成的互操作程序集放置在磁盘上的位置。Gets or sets the location on disk where the generated interop assembly is placed.

方法

CreateObjRef(Type)

创建一个对象,该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(继承自 MarshalByRefObject)
Equals(Object)

确定指定对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)
Execute()

此 API 支持产品基础结构,不能在代码中直接使用。

任务入口点。Task entry point.

GetHashCode()

作为默认哈希函数。Serves as the default hash function.

(继承自 Object)
GetLifetimeService()

检索控制此实例的生存期策略的当前生存期服务对象。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(继承自 MarshalByRefObject)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
InitializeLifetimeService()

重写以赋予从这个类派生的任务无限的租约时间。Overridden to give tasks deriving from this class infinite lease time. 否则,我们最终会获得一个有限的租约(大约 5 分钟),如果任务实例处理时间较长,就会过期。Otherwise we end up with a limited lease (5 minutes I think) and task instances can expire if they take long time processing.

(继承自 AppDomainIsolatedTask)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
MemberwiseClone(Boolean)

创建当前 MarshalByRefObject 对象的浅表副本。Creates a shallow copy of the current MarshalByRefObject object.

(继承自 MarshalByRefObject)
ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(继承自 Object)

适用于