ResolveAssemblyReference 작업

AllowedRelatedFileExtensions

선택적 String[] 매개 변수입니다.

서로 관련 있는 파일을 검색할 때 사용할 파일 이름 확장명입니다. 기본 확장명은 .pdb 및 .xml입니다.

Assemblies

선택적 ITaskItem[] 매개 변수입니다.

전체 경로 및 종속성을 식별해야 하는 항목을 지정합니다. 이 항목은 "System"과 같은 단순한 이름을 가질 수도 있고 "System, Version=2.0.3500.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"와 같은 강력한 이름을 가질 수도 있습니다.

이 매개 변수에 전달된 항목은 필요한 경우 다음과 같은 항목 메타데이터를 포함할 수 있습니다.

• Private: Boolean 값입니다. true이면 항목이 로컬로 복사됩니다. 기본값은 true입니다.

• HintPath: String 값입니다. 참조로 사용할 경로 및 파일 이름을 지정합니다. 이 값은 SearchPaths 매개 변수에 {HintPathFromItem}이 지정된 경우에 사용됩니다. 기본값은 빈 문자열입니다.

• SpecificVersion: Boolean 값입니다. true이면 Include 특성에 지정된 정확한 이름이 일치해야 합니다. false이면 단순한 이름이 같은 모든 어셈블리가 검색됩니다. SpecificVersion을 지정하지 않으면 항목의 Include 특성 값이 검사됩니다. 특성이 단순한 이름이면 SpecificVersion이 false인 것처럼 동작하고 특성이 강력한 이름이면 SpecificVersion이 true인 것처럼 동작합니다.

• ExecutableExtension: String 값입니다. 해당 값이 있으면 확인된 어셈블리는 이 확장명을 가져야 하고 해당 값이 없으면 검토된 각 디렉터리에서 맨 먼저 .dll이 검색되고 다음으로 .exe가 검색됩니다.

• SubType: String 값입니다. SubType 메타데이터가 비어 있는 항목만 전체 어셈블리 경로로 확인됩니다. SubType 메타데이터가 비어 있지 않은 항목은 무시됩니다.

• AssemblyFolderKey: String 값입니다. 레거시를 위해 지원되는 이 메타데이터는 Assemblies가 어셈블리 참조를 확인하는 데 사용해야 하는 "hklm\VendorFolder"와 같은 사용자 정의 레지스트리 키를 지정합니다.

AutoUnify

선택적 Boolean 매개 변수입니다.

true이면 결과 종속성 그래프는 App.Config 파일이 AppConfigFile 매개 변수로 전달된 것처럼 취급됩니다. 이 가상 App.Config 파일에는 충돌하는 각 어셈블리 집합에 대해 가장 최신 버전의 어셈블리를 선택하도록 하는 bindingRedirect 항목이 있습니다. 따라서 모든 충돌이 해결되므로 충돌하는 어셈블리에 대한 경고가 발생하지 않습니다. 각 매핑 작업을 다시 수행하면 이전 버전 및 최신 버전을 나타내고, AutoUnify가 true이기 때문에 이 작업이 자동으로 수행되었음을 나타내는 우선 순위 설명이 표시됩니다.

false이면 어셈블리 버전 재매핑 작업은 자동으로 수행되지 않습니다. 한 어셈블리의 버전이 2개 있으면 경고가 표시됩니다. 같은 어셈블리의 다른 버전 사이에서 충돌이 발생할 때마다 우선 순위 설명이 표시됩니다. 이러한 설명이 모두 표시된 후에는 고유한 오류 코드와 함께 "동일한 종속 어셈블리의 서로 다른 버전에서 충돌이 발생했습니다"라는 경고가 나타납니다.

기본값은 false입니다.

CopyLocalFiles

선택적 ITaskItem[] 읽기 전용 출력 매개 변수입니다.

ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles 및 ScatterFiles 매개 변수에서 CopyLocal 항목 메타데이터 값이 true인 모든 파일을 반환합니다.

FindDependencies

선택적 Boolean 매개 변수입니다.

true이면 종속성이 검색되고, 그렇지 않으면 주 참조만 검색됩니다. 기본값은 true입니다.

FindSatellites

선택적 Boolean 매개 변수입니다.

true이면 위성 어셈블리가 검색됩니다. 기본값은 true.입니다.

FullTargetFrameworkSubsetNames

선택적 String[] 매개 변수입니다.

대상 프레임워크 하위 집합 이름 목록을 포함합니다. 목록의 하위 집합 이름이 TargetFrameworkSubset 이름 속성 중 하나와 일치하면 빌드 시 해당 대상 프레임워크 하위 집합이 제외됩니다.

IgnoreDefaultInstalledAssemblySubsetTables

선택적 Boolean 매개 변수입니다.

true이면 TargetFrameworkDirectories 아래의 \SubsetList 디렉터리에 있는 설치된 추가 어셈블리 하위 집합 테이블(또는 "Subset Lists")이 검색되어 사용됩니다 기본값은 false입니다.

InstalledAssemblyTables

선택적 String 매개 변수입니다.

대상 컴퓨터에 설치되어야 하는 어셈블리를 지정하는 XML 파일 목록을 포함합니다.

InstalledAssemblyTables가 설정되면 목록의 이전 어셈블리 버전은 XML에 있는 새 버전에 병합됩니다. 또한 InGAC='true'로 설정되어 있는 어셈블리는 필수 구성 요소로 간주되어 명시적으로 재정의되지 않는 한 CopyLocal='false'로 설정됩니다.

필요한 경우 이 목록의 항목은 "FrameworkDirectory" 메타데이터를 지정하여 InstalledAssemblyTable을 특정 프레임워크 디렉터리에 연결할 수 있습니다. 하지만 Redist 이름이

"Microsoft-Windows-CLRCoreComp"로 시작되지 않으면 이 설정은 무시됩니다.

TargetFrameworkDirectories 요소가 하나만 있으면 이 목록에서 "FrameworkDirectory" 메타데이터가 없는 모든 항목은

TargetFrameworkDirectories에 전달된 고유한 값으로 설정된 것으로 처리됩니다.

ResolvedDependencyFiles

선택적 ITaskItem[] 읽기 전용 출력 매개 변수입니다.

종속성에 대한 n 번째 경로를 포함합니다. 이 매개 변수는 ResolvedFiles 매개 변수에 포함되어 있는 첫 번째 주 참조를 포함하지 않습니다.

이 매개 변수의 항목에는 다음과 같은 항목 메타데이터가 포함될 수 있습니다.

• CopyLocal: Boolean 값입니다. 지정한 참조를 출력 디렉터리에 복사할지 여부를 나타냅니다.

• FusionName: String 값입니다. 이 종속성의 이름을 지정합니다.

• ResolvedFrom: String 값입니다. 이 파일이 확인된 리터럴 검색 경로를 지정합니다.

SatelliteFiles

선택적 ITaskItem[] 읽기 전용 출력 매개 변수입니다.

찾은 위성 파일을 모두 지정합니다. 이 항목을 존재하게 만든 참조 또는 종속성이 CopyLocal=true이면 이 매개 변수도 CopyLocal=true가 됩니다.

이 매개 변수의 항목에는 다음과 같은 항목 메타데이터가 포함될 수 있습니다.

• CopyLocal: Boolean 값입니다. 지정한 참조를 출력 디렉터리에 복사할지 여부를 나타냅니다. 이 항목을 존재하게 만든 참조 또는 종속성의 CopyLocal 값이 true이면 이 값도 true입니다.

• DestinationSubDirectory: String 값입니다. 이 항목을 복사할 상대 대상 디렉터리를 지정합니다.

SearchPaths

필수적 String[] 매개 변수입니다.

디스크에서 어셈블리를 나타내는 파일을 찾기 위해 검색되는 디렉터리 또는 특별 위치를 지정합니다. 검색 경로의 나열 순서는 중요합니다. 각 어셈블리에 대해 경로 목록의 왼쪽에서 오른쪽으로 검색이 진행됩니다. 어셈블리를 나타내는 파일을 찾으면 검색은 중지되고 다음 어셈블리에 대한 검색이 시작됩니다.

이 매개 변수에는 다음 형식의 값이 지정될 수 있습니다.

• 디렉터리 경로

• {HintPathFromItem}: 작업이 기본 항목의 HintPath 메타데이터를 검토하도록 지정합니다.

• {CandidateAssemblyFiles}: 작업이 CandidateAssemblyFiles 매개 변수를 통해 전달된 파일을 검토하도록 지정합니다.

• {Registry:_AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}:

• {AssemblyFolders}: Visual Studio .NET 2003의 레지스트리에서 어셈블리 찾기 체계를 사용하도록 지정합니다.

• {GAC}: 작업이 GAC에서 검색하도록 지정합니다.

• {RawFileName}: 작업이 항목의 Include 값을 정확한 경로 및 파일 이름으로 간주하도록 지정합니다.

StateFile

선택적 String 매개 변수입니다.

이 작업의 중간 빌드 상태를 저장할 위치를 나타내는 파일 이름을 지정합니다.

TargetFrameworkDirectories

선택적 String[] 매개 변수입니다.

대상 프레임워크 디렉터리의 경로를 지정합니다. 이 매개 변수는 결과 항목의 CopyLocal 상태를 확인하는 데 필요합니다.

이 매개 변수를 지정하지 않으면 결과 항목의 소스 항목에 대해 Private 메타데이터 값으로 true가 명시적으로 지정되지 않는 한, 어떠한 결과 항목에 대해서도 CopyLocal 값에 true가 지정되지 않습니다.

TargetFrameworkVersion

선택적 String 매개 변수입니다.

프로젝트 대상 프레임워크 버전입니다. 기본값은 비어 있으며 이는 대상 프레임워크를 기준으로 참조를 필터링하지 않음을 의미합니다.