ResolveComReference 작업ResolveComReference Task

하나 이상의 형식 라이브러리 이름 또는 .tlb 파일 목록을 가져온 후 해당 형식 라이브러리를 디스크의 위치로 확인합니다.Takes a list of one or more type library names or .tlb files and resolves those type libraries to locations on disk.

매개 변수Parameters

다음 표에서는 ResolveCOMReference 작업의 매개 변수에 대해 설명합니다.The following table describes the parameters of the ResolveCOMReference task.

매개 변수Parameter 설명Description
DelaySign 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true인 경우 공개 키를 어셈블리에 배치합니다.If true, places the public key in the assembly. false인 경우 어셈블리에 완전히 서명합니다.If false, fully signs the assembly.
EnvironmentVariables 선택적 String[] 매개 변수입니다.Optional String[] parameter.

등호로 구분된 환경 변수 쌍의 배열입니다.Array of pairs of environment variables, separated by equal signs. 이러한 변수는 생성된 tlbimp.exe 및 aximp.exe에 전달되면서 일반 환경 블록에 추가되거나 일부 일반 환경 블록을 재정의합니다.These variables are passed to the spawned tlbimp.exe and aximp.exe in addition to, or selectively overriding, the regular environment block..
ExecuteAsTool 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true이면 해당 대상 프레임워크 out-of-proc에서 tlbimp.exe 및 aximp.exe를 실행하여 필요한 래퍼 어셈블리를 생성합니다.If true, runs tlbimp.exe and aximp.exe from the appropriate target framework out-of-proc to generate the necessary wrapper assemblies. 이 매개 변수는 멀티 타기팅을 허용합니다.This parameter enables multi-targeting.
IncludeVersionInInteropName 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true인 경우 typelib 버전이 래퍼 이름이 포함됩니다.If true, the typelib version will be included in the wrapper name. 기본값은 false입니다.The default is false.
KeyContainer 선택적 String 매개 변수입니다.Optional String parameter.

공개/개인 키 쌍을 보관할 컨테이너를Specifies a container that holds a public/private

지정합니다.key pair.
KeyFile 선택적 String 매개 변수입니다.Optional String parameter.

공개/개인 키 쌍을 포함할 항목을Specifies an item that contains a public/private

지정합니다.key pair.
NoClassMembers 선택적 Boolean 매개 변수입니다.Optional Booleanparameter.
ResolvedAssemblyReferences 선택적 ITaskItem[] 출력 매개 변수입니다.Optional ITaskItem[] output parameter.

확인된 어셈블리 참조를 지정합니다.Specifies the resolved assembly references.
ResolvedFiles 선택적 ITaskItem[] 출력 매개 변수입니다.Optional ITaskItem[] output parameter.

디스크에서 이 작업에 대한 입력으로 제공된 형식 라이브러리의 물리적 위치에 해당하는 정규화된 파일을 지정합니다.Specifies 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 선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[]parameter.
SdkToolsPath 선택적 System.String 매개 변수입니다.Optional System.String parameter.

ExecuteAsTooltrue인 경우 이 매개 변수를 대상이 되는 프레임워크 버전의 SDK 도구 경로로 설정해야 합니다.If ExecuteAsTool is true, this parameter must be set to the SDK tools path for the framework version being targeted.
StateFile 선택적 String 매개 변수입니다.Optional String parameter.

COM 구성 요소 타임스탬프에 대한 캐시 파일을 지정합니다.Specifies the cache file for COM component timestamps. 이 매개 변수가 없으면 실행할 때마다 모든 래퍼가 다시 생성됩니다.If not present, every run will regenerate all the wrappers.
TargetFrameworkVersion 선택적 String 매개 변수입니다.Optional String parameter.

프로젝트 대상 프레임워크 버전을 지정합니다.Specifies the project target framework version.

기본값은 String.Empty입니다.The default is String.Empty. 대상 프레임워크를 기반으로 하는 참조에 대한 필터링이 없음을 의미합니다.which means there is no filtering for a reference based on the target framework.
TargetProcessorArchitecture 선택적 String 매개 변수입니다.Optional String parameter.

기본 대상 프로세서 아키텍처를 지정합니다.Specifies the preferred target processor architecture. 변환 후에 tlbimp.exe /machine 플래그에 전달됩니다.Passed to the tlbimp.exe /machine flag after translation.

매개 변수 값은 ProcessorArchitecture의 멤버여야 합니다.The parameter value should be a member of ProcessorArchitecture.
TypeLibFiles 선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

COM 참조에 대한 형식 라이브러리 파일 경로를 지정합니다.Specifies the type library file path to COM references. 이 매개 변수에 포함된 항목에는 항목 메타데이터가 포함될 수 있습니다.Items included in this parameter may contain item metadata. 자세한 내용은 아래 “TypeLibFiles 항목 메타데이터” 섹션을 참조하세요.For more information, see the section "TypeLibFiles Item Metadata" below.
TypeLibNames 선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

확인할 형식 라이브러리 이름을 지정합니다.Specifies the type library names to resolve. 이 매개 변수에 포함된 항목에는 일부 항목 메타데이터가 포함되어야 합니다.Items included in this parameter must contain some item metadata. 자세한 내용은 아래 “TypeLibNames 항목 메타데이터” 섹션을 참조하세요.For more information, see the section "TypeLibNames Item Metadata" below.
WrapperOutputDirectory 선택적 String 매개 변수입니다.Optional String parameter.

생성된 interop 어셈블리를 배치할 디스크의 위치입니다.The location on disk where the generated interop assembly is placed. 이 항목 메타데이터를 지정하지 않으면 작업은 프로젝트 파일이 있는 디렉터리의 절대 경로를 사용합니다.If this item metadata is not specified, the task uses the absolute path of the directory where the project file is located.

설명Remarks

TypeLibNames 항목 메타데이터TypeLibNames Item Metadata

다음 표에서는 TypeLibNames 매개 변수에 전달된 항목에 사용 가능한 항목 메타데이터를 설명합니다.The following table describes the item metadata available for items passed to the TypeLibNames parameter.

메타데이터Metadata 설명Description
GUID 필수 항목 메타데이터입니다.Required item metadata.

형식 라이브러리의 GUID입니다.The GUID for the type library. 이 항목 메타데이터를 지정하지 않으면 작업이 실패합니다.If this item metadata is not specified , the task fails.
VersionMajor 필수 항목 메타데이터입니다.Required item metadata.

형식 라이브러리의 주 버전입니다.The major version of the type library. 이 항목 메타데이터를 지정하지 않으면 작업이 실패합니다.If this item metadata is not specified , the task fails.
VersionMinor 필수 항목 메타데이터입니다.Required item metadata.

형식 라이브러리의 부 버전입니다.The minor version of the type library. 이 항목 메타데이터를 지정하지 않으면 작업이 실패합니다.If this item metadata is not specified, the task fails.
LocaleIdentifier 선택적 항목 메타데이터입니다.Optional item metadata.

형식 라이브러리의 로캘 식별자(또는 LCID)입니다.The Locale Identifier (or LCID) for the type library. 이 항목 메타데이터는 사용자, 지역 또는 응용 프로그램에서 선호되는 인간 언어를 나타내는 32비트 값으로 지정됩니다.This is specified as a 32-bit value that identifies the human language preferred by a user, region, or application. 이 항목 메타데이터를 지정하지 않으면 작업에서 기본 로캘 식별자 “0”이 사용됩니다.If this item metadata is not specified, the task uses a default locale identifier of "0".
WrapperTool 선택적 항목 메타데이터입니다.Optional item metadata.

이 형식 라이브러리의 어셈블리 래퍼를 생성하는 데 사용되는 래퍼 도구를 지정합니다.Specifies the wrapper tool that is used to generate the assembly wrapper for this type library. 이 항목 메타데이터를 지정하지 않으면 작업에서 기본 래퍼 도구 “tlbimp”가 사용됩니다.If this item metadata is not specified, the task uses a default wrapper tool of "tlbimp". 사용 가능한 typelib(대/소문자 구분)는 다음과 같습니다.The available, case insensitive choices of typelibs are:

- Primary: COM 구성 요소에 대한 이미 생성된 주 interop 어셈블리를 사용하려면 이 래퍼 도구를 사용합니다.- Primary: Use this wrapper tool when you want to use an already generated primary interop assembly for the COM component. 이 래퍼 도구를 사용할 경우 래퍼 출력 디렉터리를 지정하지 마세요. 지정하면 작업이 실패합니다.When you use this wrapper tool, do not specify a wrapper output directory because that will cause the task to fail.
- TLBImp: COM 구성 요소에 대한 interop 어셈블리를 생성하려면 이 래퍼 도구를 사용합니다.- TLBImp: Use this wrapper tool when you want to generate an interop assembly for the COM component.
- AXImp: ActiveX 컨트롤에 대한 interop 어셈블리를 생성하려면 이 래퍼 도구를 사용합니다.- AXImp:Use this wrapper tool when you want to generate an interop assembly for an ActiveX Control.

TypeLibFiles 항목 메타데이터TypeLibFiles Item Metadata

다음 표에서는 TypeLibFiles 매개 변수에 전달된 항목에 사용 가능한 항목 메타데이터를 설명합니다.The following table describes the item metadata available for items passed to the TypeLibFiles parameter.

메타데이터Metadata 설명Description
WrapperTool 선택적 항목 메타데이터입니다.Optional item metadata.

이 형식 라이브러리의 어셈블리 래퍼를 생성하는 데 사용되는 래퍼 도구를 지정합니다.Specifies the wrapper tool that is used to generate the assembly wrapper for this type library. 이 항목 메타데이터를 지정하지 않으면 작업에서 기본 래퍼 도구 “tlbimp”가 사용됩니다.If this item metadata is not specified, the task uses a default wrapper tool of "tlbimp". 사용 가능한 typelib(대/소문자 구분)는 다음과 같습니다.The available, case insensitive choices of typelibs are:

- Primary: COM 구성 요소에 대한 이미 생성된 주 interop 어셈블리를 사용하려면 이 래퍼 도구를 사용합니다.- Primary: Use this wrapper tool when you want to use an already generated primary interop assembly for the COM component. 이 래퍼 도구를 사용할 경우 래퍼 출력 디렉터리를 지정하지 마세요. 지정하면 작업이 실패합니다.When you use this wrapper tool, do not specify a wrapper output directory because that will cause the task to fail.
- TLBImp: COM 구성 요소에 대한 interop 어셈블리를 생성하려면 이 래퍼 도구를 사용합니다.- TLBImp: Use this wrapper tool when you want to generate an interop assembly for the COM component.
- AXImp: ActiveX 컨트롤에 대한 interop 어셈블리를 생성하려면 이 래퍼 도구를 사용합니다.- AXImp: Use this wrapper tool when you want to generate an interop assembly for an ActiveX Control.

참고

형식 라이브러리를 고유하게 식별하기 위해 더 많은 정보를 제공할수록 작업이 디스크에서 올바른 파일로 확인될 가능성이 커집니다.The more information that you provide to uniquely identify a type library, the greater the possibility that the task will resolve to the correct file on disk.

설명Remarks

이 작업은 위에 나와 있는 매개 변수 외에 Task 클래스의 매개 변수도 상속합니다.In addition to the parameters listed above, this task inherits parameters from the Task class. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 Task 기본 클래스를 참조하세요.For a list of these additional parameters and their descriptions, see Task Base Class.

참고 항목See Also

작업 Tasks
작업 참조Task Reference