ResolveComReference 작업
하나 이상의 형식 라이브러리 이름이나 .tlb 파일의 목록을 가져오고 이러한 형식 라이브러리를 디스크상의 위치로 확인합니다.
매개 변수
다음 표에서는 ResolveCOMReference 작업의 매개 변수에 대해 설명합니다.
Parameter |
설명 |
|---|---|
DelaySign |
선택적 Boolean 매개 변수입니다. true인 경우 어셈블리에 공개 키를 두고, false이면 어셈블리에 완전히 서명합니다. |
EnvironmentVariables |
선택적 String[] 매개 변수입니다. 등호로 구분된 환경 변수 쌍의 배열입니다. 이 변수는 생성된 tlbimp.exe 및 aximp.exe에 전달되면서 일반 환경 블록에 추가되거나 일부 일반 환경 블록을 재정의합니다. |
ExecuteAsTool |
선택적 Boolean 매개 변수입니다. true이면 적절한 대상 프레임워크의 tlbimp.exe 및 aximp.exe가 out-of-proc로 실행되어 필요한 래퍼 어셈블리를 생성합니다. 이 기능을 멀티 타기팅이라고 합니다. |
IncludeVersionInInteropName |
선택적 Boolean 매개 변수입니다. true인 경우 typelib 버전이 래퍼 이름에 포함됩니다. 기본값은 false입니다. |
KeyContainer |
선택적 String 매개 변수입니다. 공개/개인을 보관하는 컨테이너를 지정합니다. 키 쌍. |
KeyFile |
선택적 String 매개 변수입니다. 공개/개인을 포함하는 항목을 지정합니다. 키 쌍. |
NoClassMembers |
선택적 Boolean 매개 변수입니다. |
ResolvedAssemblyReferences |
선택적 ITaskItem[] 출력 매개 변수입니다. 확인된 어셈블리 참조를 지정합니다. |
ResolvedFiles |
선택적 ITaskItem[] 출력 매개 변수입니다. 이 작업에 대한 입력으로 제공된 형식 라이브러리의 실제 위치에 해당하는 디스크 상의 정규화된 파일을 지정합니다. |
ResolvedModules |
선택적 ITaskItem[] 매개 변수입니다. |
SdkToolsPath |
선택적 [String] 매개 변수입니다. ExecuteAsTool이 true이면 이 매개 변수는 대상으로 지정되는 프레임워크 버전의 SDK 도구 경로로 설정해야 합니다. |
StateFile |
선택적 [String] 매개 변수입니다. COM 구성요소 타임스탬프의 캐시 파일을 지정합니다. 래퍼가 없는 경우 모든 실행으로 모든 래퍼가 재생성됩니다. |
TargetFrameworkVersion |
선택적 [String] 매개 변수입니다. 프로젝트의 대상 프레임워크 버전을 지정합니다. 기본값은 String.Empty입니다. 대상 프레임워크를 기준으로 참조에 대한 필터링이 없다는 의미입니다. |
TargetProcessorArchitecture |
선택적 [String] 매개 변수입니다. 기본 대상 프로세서 아키텍처를 지정합니다. 전환 후 tlbimp.exe/컴퓨터 플래그로 전달됩니다. 매개 변수 값은 ProcessorArchitecture의 멤버이어야 합니다. |
TypeLibFiles |
선택적 ITaskItem[] 매개 변수입니다. COM 참조에 대한 형식 라이브러리 파일 경로를 지정합니다. 이 매개 변수에 포함된 항목에는 항목 메타데이터가 있을 수 있습니다. 자세한 내용은 아래의 "TypeLibFiles 항목 메타데이터" 단원을 참조하십시오. |
TypeLibNames |
선택적 ITaskItem[] 매개 변수입니다. 확인할 형식 라이브러리 이름을 지정합니다. 이 매개 변수에 포함된 항목에는 항목 메타데이터가 있어야 합니다. 자세한 내용은 아래의 "TypeLibNames 항목 메타데이터" 단원을 참조하십시오. |
WrapperOutputDirectory |
선택적 String 매개 변수입니다. 생성된 interop 어셈블리가 배치되는 디스크 상의 위치입니다. 이 항목 메타데이터를 지정하지 않으면 작업에서 프로젝트 파일이 있는 디렉터리의 절대 경로를 사용합니다. |
설명
64비트 컴퓨터의 32비트 구성 요소를 대상으로 지정
64비트 컴퓨터에서 Framework64/<version>/msbuild는 32비트 구성 요소로 등록된 COM 개체를 확인할 수 없습니다. 예를 들어, regsvr32를 사용하여 COM 개체를 등록한 다음 Framework64/<version>/msbuild를 사용하여 x86을 대상으로 하는 프로젝트를 빌드하려는 경우 빌드는 COM 개체를 확인할 수 없습니다. 대신 Framework/<version>/msbuild를 빌드하는 경우 빌드는 COM 개체를 확인할 수 있습니다.
TypeLibNames 항목 메타데이터
다음 표에서는 TypeLibNames 매개 변수에 전달된 항목에 대해 사용할 수 있는 항목 메타데이터를 설명합니다.
메타데이터 |
설명 |
|---|---|
GUID |
필수적 항목 메타데이터입니다. 형식 라이브러리에 대한 GUID입니다. 이 항목 메타데이터를 지정하지 않으면 작업이 실패합니다. |
VersionMajor |
필수적 항목 메타데이터입니다. 형식 라이브러리의 주 버전입니다. 이 항목 메타데이터를 지정하지 않으면 작업이 실패합니다. |
VersionMinor |
필수적 항목 메타데이터입니다. 형식 라이브러리의 부 버전입니다. 이 항목 메타데이터를 지정하지 않으면 작업이 실패합니다. |
LocaleIdentifier |
선택적 항목 메타데이터입니다. 형식 라이브러리의 LCID(로캘 식별자)입니다. 사용자, 영역 또는 응용 프로그램에 의해 기본 설정된 언어를 식별하는 값을 32비트로 지정합니다. 이 항목 메타데이터를 지정하지 않으면 작업에서 기본 로캘 식별자인 "0"을 사용합니다. |
WrapperTool |
선택적 항목 메타데이터입니다. 이 형식 라이브러리에 대한 어셈블리 래퍼를 생성하는 데 사용되는 래퍼 도구를 지정합니다. 이 항목 메타데이터를 지정하지 않으면 작업에서 기본 래퍼 도구인 "tlbimp"를 사용합니다. typelibs의 선택 가능한 항목은 다음과 같으며 대/소문자를 구분하지 않습니다.
|
TypeLibFiles 항목 메타데이터
다음 표에서는 TypeLibFiles 매개 변수에 전달된 항목에 대해 사용할 수 있는 항목 메타데이터를 설명합니다.
메타데이터 |
설명 |
|---|---|
WrapperTool |
선택적 항목 메타데이터입니다. 이 형식 라이브러리에 대한 어셈블리 래퍼를 생성하는 데 사용되는 래퍼 도구를 지정합니다. 이 항목 메타데이터를 지정하지 않으면 작업에서 기본 래퍼 도구인 "tlbimp"를 사용합니다. typelibs의 선택 가능한 항목은 다음과 같으며 대/소문자를 구분하지 않습니다.
|
.gif "참고") 참고 |
|---|
형식 라이브러리를 고유하게 식별하는 정보를 많이 제공할수록 작업이 디스크 상의 올바른 파일로 해석될 가능성이 커집니다. |
설명
위에 나열된 매개 변수 외에도 이 작업은 Task 클래스의 매개 변수를 상속합니다. 추가 매개 변수 목록과 해당 설명은 작업 기본 클래스를 참조하십시오.