ResolveAssemblyReference 작업ResolveAssemblyReference Task

지정된 어셈블리에 종속된 모든 어셈블리를 결정합니다.Determines all assemblies that depend on the specified assemblies. 여기에는 2차 및 n차 종속성이 포함됩니다.This includes second and nth-order dependencies.

매개 변수Parameters

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

매개 변수Parameter 설명Description
AllowedAssemblyExtensions 선택적 String[] 매개 변수입니다.Optional String[] parameter.

참조를 확인할 때 사용할 어셈블리 파일 확장명입니다.The assembly file name extensions to use when resolving references. 기본 파일 확장명은 .exe 및 .dll입니다.The default file name extensions are .exe and .dll.
AllowedRelatedFileExtensions 선택적 String[] 매개 변수입니다.Optional String[] parameter.

서로 관련된 파일을 검색하는 데 사용할 파일 확장명입니다.The file name extensions to use for a search for files that are related to one another. 기본 확장명은 .pdb 및 .xml입니다.The default extensions are .pdb and .xml.
AppConfigFile 선택적 String 매개 변수입니다.Optional String parameter.

구문 분석하고 bindingRedirect 매핑을 추출할 app.config 파일을 지정합니다.Specifies an app.config file from which to parse and extract bindingRedirect mappings. 이 매개 변수가 지정되어 있으면 AutoUnify 매개 변수가 false여야 합니다.If this parameter is specified, the AutoUnify parameter must be false.
AutoUnify 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

이 매개 변수는 일반 App.Config 파일을 가질 수 없는 DLL과 같은 어셈블리 빌드에 사용됩니다.This parameter is used for building assemblies, such as DLLs, which cannot have a normal App.Config file.

true면 자동으로 결과 종속성 그래프가 AppConfigFile 매개 변수에 전달된 App.Config 파일이 있었던 것처럼 처리됩니다.When true, the resulting dependency graph is automatically treated as if there were anApp.Config file passed in to the AppConfigFile parameter. 이 가상 App.Config 파일에는 가장 높은 버전 어셈블리가 선택되도록 충돌하는 각 어셈블리 집합에 대한 bindingRedirect 항목이 있습니다.This virtual App.Config file has a bindingRedirect entry for each conflicting set of assemblies such that the highest version assembly is chosen. 모든 충돌은 해결될 것이므로 이에 대한 결과는 충돌하는 어셈블리에 대한 경고가 없을 것이라는 것입니다.A consequence of this is that there will never be a warning about conflicting assemblies because every conflict will have been resolved.

true면, 각각의 고유한 재매핑에 대해 이전 버전과 새 버전을 보여 주는 높은 우선 순위 주석이 표시되며, 해당 AutoUnifytrue입니다.When true, each distinct remapping will result in a high priority comment showing the old and new versions and that AutoUnify was true.

true면, AppConfigFile 매개 변수는 비어 있어야 합니다.When true, the AppConfigFile parameter must be empty

false이면, 어셈블리 버전 재매핑은 자동으로 발생하지 않습니다.When false, no assembly version remapping will occur automatically. 두 버전의 어셈블리가 있는 경우에는 경고가 발생합니다.When two versions of an assembly are present, a warning is issued.

false이면, 동일한 어셈블리의 서로 다른 버전 간 충돌 시 각각의 고유한 충돌에 대해 높은 우선 순위 주석이 표시됩니다.When false, each distinct conflict between different versions of the same assembly results in a high-priority comment. 이 주석 다음에 단일 경고가 표시됩니다.These comments are followed by a single warning. 이 경고에는 고유한 오류 코드와 "참조와 종속 어셈블리의 서로 다른 버전 사이에 충돌이 발생했습니다"라는 텍스트가 포함되어 있습니다.The warning has a unique error code and contains text that reads "Found conflicts between different versions of reference and dependent assemblies".
Assemblies 선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

식별해야 하는 전체 경로 및 종속성에 대한 항목을 지정합니다.Specifies the items for which full paths and dependencies must be identified. 이러한 항목은 "System"과 같은 단순한 이름이나 "System, Version=2.0.3500.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"와 같은 강력한 이름을 포함할 수 있습니다.These items can have either simple names like "System" or strong names like "System, Version=2.0.3500.0, Culture=neutral, PublicKeyToken=b77a5c561934e089."

이 매개 변수에 전달된 항목에는 원할 경우 다음의 항목 메타데이터를 포함할 수 있습니다.Items passed to this parameter may optionally have the following item metadata:

- Private: Boolean 값입니다.- Private: Boolean value. true면, 항목이 로컬로 복사됩니다.If true, then the item is copied locally. 기본값은 true입니다.The default value is true.
- HintPath: String 값입니다.- HintPath: String value. 참조로 사용할 경로 및 파일 이름을 지정합니다.Specifies the path and file name to use as a reference. {HintPathFromItem}이 SearchPaths 매개 변수에 지정되면 사용됩니다.This is used when {HintPathFromItem} is specified in the SearchPaths parameter. 기본값은 빈 문자열입니다.The default value is an empty string.
- SpecificVersion: Boolean 값입니다.- SpecificVersion: Boolean value. true일 경우, Include 특성에 지정된 정확한 이름이 일치해야 합니다.If true, then the exact name specified in the Include attribute must match. false일 경우, 동일한 단순 이름의 모든 어셈블리가 작동합니다.If false, then any assembly with the same simple name will work. SpecificVersion 을 지정하지 않으면 작업에서 해당 항목의 Include 특성에 있는 값이 검사됩니다.If SpecificVersion is not specified, then the task examines the value in the Include attribute of the item. 특성은 단순 이름일 경우 SpecificVersionfalse여야 합니다.If the attribute is a simple name, it behaves as if SpecificVersion was false. 강력한 이름일 경우에는 SpecificVersiontrue여야 합니다.If the attribute is a strong name, it behaves as if SpecificVersion was true.
참조 항목 유형과 함께 사용하는 경우는 Include 특성이 확인할 어셈블리의 전체 Fusion 이름이어야 합니다.When used with a Reference item type, the Include attribute needs to be the full fusion name of the assembly to be resolved. 어셈블리는 Fusion이 Include 특성과 정확하게 일치하는 경우에만 확인됩니다.The assembly is only resolved if fusion exactly matches the Include attribute.
프로젝트가 .NET Framework 버전을 대상으로 하고 더 높은 .NET Framework 버전에 대해 컴파일된 어셈블리를 참조하는 경우에는, 참조에 SpecificVersiontrue여야 합니다.When a project targets a .NET Framework version and references an assembly compiled for a higher .NET Framework version, the reference resolves only if it has SpecificVersion set to true.
프로젝트가 프로필을 대상으로 하고 프로필에 없는 어셈블리를 참조하는 경우에는, 참조에 SpecificVersiontrue여야 합니다.When a project targets a profile and references an assembly that is not in the profile, the reference resolves only if it has SpecificVersion set to true.
- ExecutableExtension: String 값입니다.- ExecutableExtension: String value. 이 메타데이터가 있으면 확인된 어셈블리에 이 확장이 있어야 합니다.When present, the resolved assembly must have this extension. 없으면 검사된 각 디렉터리에 대해 .dll이 첫 번째로 고려되고 .exe가 그 다음으로 고려됩니다.When absent, .dll is considered first, followed by .exe, for each examined directory.
- SubType: String 값입니다.- SubType: String value. 빈 SubType 메타데이터가 있는 항목만 전체 어셈블리 경로로 확인됩니다.Only items with empty SubType metadata will be resolved into full assembly paths. 비어 있지 않은 SubType 메타데이터를 사용하는 항목은 무시됩니다.Items with non-empty SubType metadata are ignored.
- AssemblyFolderKey: String 값입니다.- AssemblyFolderKey: String value. 이 메타데이터는 레거시용으로 지원됩니다.This metadata is supported for legacy purposes. “hklm\VendorFolder”와 같이, Assemblies에서 어셈블리 참조를 확인하는 데 사용해야 하는 사용자 정의 레지스트리 키를 지정합니다.It specifies a user-defined registry key, such as "hklm\VendorFolder", that Assemblies should use to resolve assembly references.
AssemblyFiles 선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

종속성을 찾을 정규화된 어셈블리의 목록을 지정합니다.Specifies a list of fully qualified assemblies for which to find dependencies.

이 매개 변수에 전달된 항목에는 원할 경우 다음의 항목 메타데이터를 포함할 수 있습니다.Items passed to this parameter may optionally have the following item metadata:

- Private: 선택적 Boolean 값입니다.- Private: an optional Boolean value. true면, 항목이 로컬로 복사됩니다.If true, the item is copied locally.
- FusionName: 선택적 String 메타데이터입니다.- FusionName: optional String metadata. 이 항목에 대한 단순 또는 강력한 이름을 지정합니다.Specifies the simple or strong name for this item. 이 특성이 있는 경우 이름을 알기 위해 어셈블리 파일을 열 필요가 없으므로 시간을 절약할 수 있습니다.If this attribute is present, it can save time because the assembly file does not have to be opened to get the name.
AutoUnify 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true면 자동으로 결과 종속성 그래프가 AppConfigFile 매개 변수에 전달된 App.Config 파일이 있었던 것처럼 처리됩니다.If true, the resulting dependency graph is automatically treated as if there were an App.Config file passed in to the AppConfigFile parameter. 이 가상 App.Config 파일에는 가장 높은 버전 어셈블리가 선택되도록 충돌하는 각 어셈블리 집합에 대한 bindingRedirect 항목이 있습니다.This virtual App.Config file has a bindingRedirect entry for each conflicting set of assemblies so that the highest version assembly is chosen. 모든 충돌은 해결될 것이므로 이에 대한 결과는 충돌하는 어셈블리에 대한 경고가 없을 것이라는 것입니다.A result of this is that there will never be a warning about conflicting assemblies because every conflict will have been resolved. 각각의 고유한 재매핑 시에는 AutoUnifytrue여야 합니다.Each distinct remapping will cause a high priority comment that indicates the old and new versions and the fact that this was done automatically because AutoUnify was true.

false이면, 어셈블리 버전 재매핑은 자동으로 발생하지 않습니다.If false, no assembly version remapping will occur automatically. 두 버전의 어셈블리가 있는 경우에는 경고가 발생합니다.When two versions of an assembly are present, there will be a warning. 동일한 어셈블리의 서로 다른 버전 간 충돌 시에는 각각의 고유한 충돌에 대해 높은 우선 순위 주석이 표시됩니다.Each distinct conflict between different versions of the same assembly will cause a high priority comment. 이 주석들이 모두 표시되면 고유한 오류 코드와 "참조와 종속 어셈블리의 서로 다른 버전 사이에 충돌이 발생했습니다"라는 텍스트가 포함된 단일 경고가 표시됩니다.After all these comments are displayed, there will be a single warning with a unique error code and text that reads "Found conflicts between different versions of reference and dependent assemblies".

기본값은 false여야 합니다.The default value is false.
CandidateAssemblyFiles 선택적 String[] 매개 변수입니다.Optional String[] parameter.

검색 및 확인 프로세스에 사용할 어셈블리 목록을 지정합니다.Specifies a list of assemblies to use for the search and resolution process. 이 매개 변수에 전달된 값은 절대 파일 이름이나 프로젝트에 상대적인 파일 이름이어야 합니다.Values passed to this parameter must be absolute file names or project-relative file names.

이 목록에 있는 어셈블리는 SearchPaths 매개 변수에 고려해야 할 경로 중 하나로서 {CandidateAssemblyFiles}가 포함되어 있는 것으로 간주됩니다.Assemblies in this list will be considered when the SearchPaths parameter contains {CandidateAssemblyFiles} as one of the paths to consider.
CopyLocalDependenciesWhenParentReferenceInGac 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true일 경우 종속성을 로컬로 복사해야 할지 결정하기 위해 확인해야 할 사항 중 하나는 프로젝트 파일에 있는 부모 참조에 개인 메타데이터가 설정되어 있는지 확인하는 것입니다.If true, to determine if a dependency should be copied locally, one of the checks done is to see if the parent reference in the project file has the Private metadata set. 설정되어 있다면 개인 값이 종속성으로 사용됩니다.If set, then the Private value is used as a dependency.

메타데이터를 설정되어 있지 않으면 종속성은 부모 참조와 동일한 검사를 통과합니다.If the metadata is not set, then the dependency goes through the same checks as the parent reference. 이러한 검사 중 하나는 참조가 GAC에 있는지 확인하는 것입니다.One of these checks is to see if the reference is in the GAC. 참조가 GAC에 있으면 참조가 대상 컴퓨터의 GAC에 있는 것으로 간주되므로 로컬로 복사되지 않습니다.If a reference is in the GAC, then it is not copied locally, because it is assumed to be in the GAC on the target machine. 이것은 특정 참조에만 적용되고 해당 종속성에는 적용되지 않습니다.This only applies to a specific reference and not its dependencies.

예를 들어 GAC에 있는 프로젝트 파일에 있는 참조는 로컬로 복사되지 않지만, 해당 종속성은 GAC에 없으므로 로컬로 복사됩니다.For example, a reference in the project file that is in the GAC is not copied locally, but its dependencies are copied locally because they are not in the GAC.

false일 경우, 프로젝트 파일 참조는 이 참조가 GAC에 있는지 알기 위해 확인되며 적절하게 로컬로 복사됩니다.If false, project file references are checked to see if they are in the GAC, and are copied locally as appropriate.

종속성은 GAC에 있는지 알기 위해 확인되고, 프로젝트 파일의 부모 참조가 GAC에 있는지 알기 위해서도 확인됩니다.Dependencies are checked to see if they are in the GAC and are also checked to see if the parent reference from the project file is in the GAC.

프로젝트 파일의 부모 참조가 GAC에 있으면 종속성은 로컬로 복사되지 않습니다.If the parent reference from the project file is in the GAC, the dependency is not copied locally.

이 매개 변수가 true든 false든 상관없이, 여러 부모 참조가 있고 이 중 어느 것도 GAC에 없다면, 이것들은 모두 로컬로 복사됩니다.Whether this parameter is true or false, if there are multiple parent references and any of them are not in the GAC, then all of them are copied locally.
CopyLocalFiles 선택적 ITaskItem[] 읽기 전용 출력 매개 변수입니다.Optional ITaskItem[] read-only output parameter.

값이 ResolvedFilesResolvedDependencyFilesRelatedFilesSatelliteFiles, ScatterFiles , CopyLocal , true여야 합니다.Returns every file in the ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles, and ScatterFiles parameters that has CopyLocal item metadata with a value of true.
FilesWritten 선택적 ITaskItem[] 출력 매개 변수입니다.Optional ITaskItem[] output parameter.

디스크에 기록된 항목을 포함합니다.Contains the items written to disk.
FindDependencies 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true일 경우, 종속성이 검색됩니다.If true, dependencies will be found. 그렇지 않은 경우에는 기본 참조만 검색됩니다.Otherwise, only primary references are found. 기본값은 true여야 합니다.The default value is true.
FindRelatedFiles 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true일 경우 .pdb 파일 및 .xml 파일과 같은 관련 파일이 검색됩니다.If true, related files such as .pdb files and .xml files will be found. 기본값은 true입니다.The default value is true.
FindSatellites 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true일 경우 위성 어셈블리가 검색됩니다.If true, satellite assemblies will be found. 기본값은 true.The default value is true.
FindSerializationAssemblies 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true일 경우, 작업에서 serialization 어셈블리를 검색합니다.If true, then the task searches for serialization assemblies. 기본값은 true입니다.The default value is true.
FullFrameworkAssemblyTables 선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

재배포 목록을 특정 프레임워크 디렉터리와 연결하기 위해 "FrameworkDirectory" 메타데이터가 있는 항목을 지정합니다.Specifies items that have "FrameworkDirectory" metadata to associate a redist list with a particular framework directory. 연결하지 못하면 오류가 기록됩니다.If the association is not made, an error will be logged. FrameworkDirectory가 설정되지 않은 경우 RAR(resolve assembly reference) 논리에서는 대상 프레임워크 디렉터리를 사용합니다.The resolve assembly reference (RAR) logic uses the target framework directory if a FrameworkDirectory is not set..
FullFrameworkFolders 선택적 System.String[] 매개 변수입니다.Optional System.String[] parameter.

RedistList 디렉터리를 포함하는 폴더 집합을 지정합니다.Specifies the set of folders which contain a RedistList directory. 이 디렉터리는 %programfiles%\reference assemblies\microsoft\framework\v4.0과 같이, 지정된 클라이언트 프로필에 대한 전체 프레임워크를 나타냅니다.This directory represents the full framework for a given client profile, for example, %programfiles%\reference assemblies\microsoft\framework\v4.0.
FullTargetFrameworkSubsetNames 선택적 String[] 매개 변수입니다.Optional String[] parameter.

대상 프레임워크 하위 집합 이름 목록을 포함합니다.Contains a list of target framework subset names. 목록에 있는 하위 집합 이름이 TargetFrameworkSubset Name 속성에 있는 것과 일치하는 경우, 시스템에서는 빌드 시 해당 특정 대상 프레임워크 하위 집합을 제외합니다.If a subset name in the list matches one in the TargetFrameworkSubset name property, then the system excludes that particular target framework subset at build time.
IgnoreDefaultInstalledAssemblyTables 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true인 경우 작업에서는 TargetFrameworkDirectories 아래의 \RedistList 디렉터리에 있는 설치된 추가 어셈블리 표(또는 “재배포 목록”)를 검색하여 사용합니다.If true, then the task searches for and uses additional installed assembly tables (or, "Redist Lists") that are found in the \RedistList directory under TargetFrameworkDirectories. 기본값은 false.The default value is false.
IgnoreDefaultInstalledAssemblySubsetTables 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true라면, 작업에서는 TargetFrameworkDirectories 아래의 \SubsetList 디렉터리에 있는 설치된 추가 어셈블리 하위 집합 표(또는 “하위 집합 목록”)를 검색하여 사용합니다.If true, then the task searches for and uses additional installed assembly subset tables (or, "Subset Lists") that are found in the \SubsetList directory under TargetFrameworkDirectories. 기본값은 false.The default value is false.
InstalledAssemblySubsetTables 선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

대상 하위 집합에 있는 것으로 예상되는 어셈블리를 지정하는 XML 파일의 목록을 포함합니다.Contains a list of XML files that specify the assemblies that are expected to be in the target subset.

옵션으로서, 이 목록의 항목이 InstalledAssemblySubsetTable을 특정 프레임워크 디렉터리와 연결할 "FrameworkDirectory" 메타데이터를 지정할 수As an option, items in this list can specify the "FrameworkDirectory" metadata to associate an InstalledAssemblySubsetTable

있습니다.with a particular framework directory.

TargetFrameworkDirectories 요소가 하나만 있다면, 이 목록에 있는 항목 중 "FrameworkDirectory" 메타데이터가 없는 모든 항목은 TargetFrameworkDirectories에 전달되는 고유한 값으로 설정된 것처럼 처리됩니다.If there is only one TargetFrameworkDirectories element, then any items in this list that lack the "FrameworkDirectory" metadata are treated as though they are set to the unique value that is passed to TargetFrameworkDirectories.
InstalledAssemblyTables 선택적 String 매개 변수입니다.Optional String parameter.

대상 컴퓨터에 설치되어 있는 것으로 예상되는 어셈블리를 지정하는 XML 파일의 목록을 포함합니다.Contains a list of XML files that specify the assemblies that are expected to be installed on the target computer.

InstalledAssemblyTables 가 설정되어 있으면, 목록에 있는 어셈블리 중 이전 버전은 XML에 나열된 최신 버전에 병합됩니다.When InstalledAssemblyTables is set, earlier versions of the assemblies in the list are merged into the newer versions that are listed in the XML. 또한 InGAC='true'라는 설정이 있는 어셈블리는 필수 조건으로 간주되며, 명시적으로 재정의하지 않으면 CopyLocal='false'로 설정됩니다.Also, assemblies that have a setting of InGAC='true' are considered prerequisites and are set to CopyLocal='false' unless explicitly overridden.

옵션으로서, 이 목록의 항목이 InstalledAssemblyTable 을 특정 프레임워크 디렉터리와 연결할 "FrameworkDirectory" 메타데이터를 지정할 수 있습니다.As an option, items in this list can specify "FrameworkDirectory" metadata to associate an InstalledAssemblyTable with a particular framework directory. 그러나, 재배포 이름이 다음과 같이 시작하지 않으면 이 설정은 무시됩니다.However, this setting is ignored unless the Redist name begins with

"Microsoft-Windows-CLRCoreComp""Microsoft-Windows-CLRCoreComp".

TargetFrameworkDirectories 요소가 하나만 있다면, 이 목록에 있는 항목 중 "FrameworkDirectory" 메타데이터가 없는 모든 항목은If there is only one TargetFrameworkDirectories element, then any items in this list that lack the "FrameworkDirectory" metadata are treated as if they are set to the unique value that is passed

TargetFrameworkDirectories에 전달되는 고유한 값으로 설정된 것처럼 처리됩니다.to TargetFrameworkDirectories.
LatestTargetFrameworkDirectories 선택적 String[] 매개 변수입니다.Optional String[] parameter.

컴퓨터에서 대상으로 지정할 수 있는 최신 프레임워크에 대한 재배포 목록이 들어 있는 디렉터리의 목록을 지정합니다.Specifies a list of directories which contain the redist lists for the most current framework which can be targeted on the machine. 설정하지 않는 경우, 지정된 대상 프레임워크 식별자에 대한 컴퓨터에 설치된 최상위 프레임워크가 사용됩니다.If this is not set then the highest framework installed on the machine for a given target framework identifier is used.
ProfileName 선택적 String 매개 변수입니다.Optional String parameter.

- 대상으로 지정할 프레임워크 프로필의 이름을 지정합니다.- Specifies the name of the framework profile to be targeted. 예를 들어, Client, Web 또는 Network가 있습니다.For example, Client, Web, or Network.
RelatedFiles 선택적 ITaskItem[] 읽기 전용 출력 매개 변수입니다.Optional ITaskItem[] read-only output parameter.

.XML 및 .pdb 파일과 같이 참조와 동일한 기본 이름을 가진 관련된 파일을 포함합니다.Contains related files, such as XML and .pdb files that have the same base name as a reference.

이 매개 변수에 나열된 파일에는 원할 경우 다음의 항목 메타데이터를 포함할 수 있습니다.The files listed in this parameter may optionally contain the following item metadata:

- Primary: Boolean 값입니다.- Primary: Boolean value. true일 경우, 파일 항목이 Assemblies 매개 변수입니다.If true, then the file item was passed into the array by using the Assemblies parameter. 기본값은 false여야 합니다.Default value is false.
- CopyLocal: Boolean 값입니다.- CopyLocal: Boolean value. 지정된 참조를 출력 디렉터리로 복사해야 하는지 여부를 나타냅니다.Indicates whether the given reference should be copied to the output directory.
ResolvedDependencyFiles 선택적 ITaskItem[] 읽기 전용 출력 매개 변수입니다.Optional ITaskItem[] read-only output parameter.

종속성에 대한 n번째 순서 경로를 포함합니다.Contains the nth order paths to dependencies. 이 매개 변수는 ResolvedFiles 매개 변수에 들어 있는 첫 번째 순서 기본 참조를 포함하지 않습니다.This parameter does not include first order primary references, which are contained in the ResolvedFiles parameter.

이 매개 변수에 있는 항목에는 원할 경우 다음의 항목 메타데이터를 포함합니다.The items in this parameter optionally contain the following item metadata:

- CopyLocal: Boolean 값입니다.- CopyLocal: Boolean value. 지정된 참조를 출력 디렉터리로 복사해야 하는지 여부를 나타냅니다.Indicates whether the given reference should be copied to the output directory.
- FusionName: String 값입니다.- FusionName: String value. 이 종속성의 이름을 지정합니다.Specifies the name for this dependency.
- ResolvedFrom: String 값입니다.- ResolvedFrom: String value. 이 파일을 확인한 리터럴 검색 경로를 지정합니다.Specifies the literal search path that this file was resolved from.
ResolvedFiles 선택적 ITaskItem[] 읽기 전용 출력 매개 변수입니다.Optional ITaskItem[] read-only output parameter.

전체 경로로 확인된 모든 기본 참조의 목록을 포함합니다.Contains a list of all primary references resolved to full paths.

이 매개 변수에 있는 항목에는 원할 경우 다음의 항목 메타데이터를 포함합니다.The items in this parameter optionally contain the following item metadata:

- CopyLocal: Boolean 값입니다.- CopyLocal: Boolean value. 지정된 참조를 출력 디렉터리로 복사해야 하는지 여부를 나타냅니다.Indicates whether the given reference should be copied to the output directory.
- FusionName: String 값입니다.- FusionName: String value. 이 종속성의 이름을 지정합니다.Specifies the name for this dependency.
- ResolvedFrom: String 값입니다.- ResolvedFrom: String value. 이 파일을 확인한 리터럴 검색 경로를 지정합니다.Specifies the literal search path that this file was resolved from.
SatelliteFiles 선택적 ITaskItem[] 읽기 전용 출력 매개 변수입니다.Optional ITaskItem[] read-only output parameter.

찾은 위성 파일을 지정합니다.Specifies any satellite files found. 이 항목을 존재하도록 한 참조 또는 종속성이 CopyLocal=true일 경우 이것은 CopyLocal=true입니다.These will be CopyLocal=true if the reference or dependency that caused this item to exist is CopyLocal=true.

이 매개 변수에 있는 항목에는 원할 경우 다음의 항목 메타데이터를 포함합니다.The items in this parameter optionally contain the following item metadata:

- CopyLocal: Boolean 값입니다.- CopyLocal: Boolean value. 지정된 참조를 출력 디렉터리로 복사해야 하는지 여부를 나타냅니다.Indicates whether the given reference should be copied to the output directory. 이 값은 이 항목을 존재하도록 한 참조 또는 종속성에 true 라는 CopyLocal 값이 있을 경우 true여야 합니다.This value is true if the reference or dependency that caused this item to exist has a CopyLocal value of true.
- DestinationSubDirectory: String 값입니다.- DestinationSubDirectory: String value. 이 항목을 복사할 상대적인 대상 디렉터리를 지정합니다.Specifies the relative destination directory to copy this item to.
ScatterFiles 선택적 ITaskItem[] 읽기 전용 출력 매개 변수입니다.Optional ITaskItem[] read-only output parameter.

지정된 어셈블리 중 하나와 연결된 분산 파일을 포함합니다.Contains the scatter files associated with one of the given assemblies.

이 매개 변수에 있는 항목에는 원할 경우 다음의 항목 메타데이터를 포함합니다.The items in this parameter optionally contain the following item metadata:

- CopyLocal: Boolean 값입니다.- CopyLocal: Boolean value. 지정된 참조를 출력 디렉터리로 복사해야 하는지 여부를 나타냅니다.Indicates whether the given reference should be copied to the output directory.
SearchPaths 필수 String[] 매개 변수입니다.Required String[] parameter.

디스크에서 어셈블리를 나타내는 파일을 찾기 위해 검색할 디렉터리 또는 특별한 위치를 지정합니다.Specifies the directories or special locations that are searched to find the files on disk that represent the assemblies. 검색 경로가 나열된 순서가 중요합니다.The order in which the search paths are listed is important. 각 어셈블리에 대한 경로 목록은 왼쪽에서 오른쪽으로 검색됩니다.For each assembly, the list of paths is searched from left to right. 어셈블리를 나타내는 파일을 찾으면 검색이 중지되고 다음 어셈블리에 대한 검색이 시작됩니다.When a file that represents the assembly is found, that search stops and the search for the next assembly starts.

이 매개 변수는 아래 목록의 디렉터리 경로 또는 특수 리터럴 값이 포함될 수 있는 세미콜론으로 구분된 값 목록을 사용합니다.This parameter accepts a semicolon-delimited list of values that can be either directory paths or special literal values from the list below:

- {HintPathFromItem}: 작업에서 기본 항목의 HintPath 메타데이터를 검사하도록 지정합니다.- {HintPathFromItem}: Specifies that the task will examine the HintPath metadata of the base item.
- {CandidateAssemblyFiles}: 작업에서 CandidateAssemblyFiles 매개 변수를 통해 전달된 파일을 검사하도록 지정합니다.- {CandidateAssemblyFiles}: Specifies that the task will examine the files passed in through the CandidateAssemblyFiles parameter.
- {Registry:_AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}: 작업이 레지스트리에 지정된 추가 폴더에서 검색하도록 지정합니다.- {Registry:_AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}: Specifies that the task will search in additional folders specified in the registry. _AssemblyFoldersBase_, _RuntimeVersion__AssemblyFoldersSuffix_은 검색할 레지스트리 위치의 특정 값으로 대체되어야 합니다._AssemblyFoldersBase_, _RuntimeVersion_, and _AssemblyFoldersSuffix_ should be replaced with specific values for the registry location to be searched. 공통 대상의 기본 사양은 {Registry:$(FrameworkRegistryBase),$(TargetFrameworkVersion),$(AssemblyFoldersSuffix)$(AssemblyFoldersExConditions)}입니다.The default specification in the common targets is {Registry:$(FrameworkRegistryBase),$(TargetFrameworkVersion),$(AssemblyFoldersSuffix)$(AssemblyFoldersExConditions)}.
- {AssemblyFolders}: 작업에서 Visual Studio.NET 2003 레지스트리에서 어셈블리 찾기 체계를 사용하도록 지정합니다.- {AssemblyFolders}: Specifies the task will use the Visual Studio.NET 2003 finding-assemblies-from-registry scheme.
- {GAC}: 작업이 GAC(전역 어셈블리 캐시)에서 검색하도록 지정합니다.- {GAC}: Specifies the task will search in the Global Assembly Cache (GAC).
- {RawFileName}: 작업에서 항목의 Include 값을 정확한 경로 및 파일 이름으로 간주하도록 지정합니다.- {RawFileName}: Specifies the task will consider the Include value of the item to be an exact path and file name.
SerializationAssemblyFiles 선택적 ITaskItem[] 읽기 전용 출력 매개 변수입니다.Optional ITaskItem[] read-only output parameter.

찾은 모든 XML Serialization 어셈블리를 포함합니다.Contains any XML serialization assemblies found. 이 항목을 존재하도록 한 참조 또는 종속성이 CopyLocal=true일 경우에만 이 항목이 CopyLocal=true로 표시됩니다.These items are marked CopyLocal=true if and only if the reference or dependency that caused this item to exist is CopyLocal=true.

Boolean 메타데이터 CopyLocal은 지정된 참조를 출력 디렉터리로 복사해야 하는지 여부를 나타냅니다.The Boolean metadata CopyLocal indicates whether the given reference should be copied to the output directory.
Silent 선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

true일 경우 메시지가 기록되지 않습니다.If true, no messages are logged. 기본값은 false입니다.The default value is false.
StateFile 선택적 String 매개 변수입니다.Optional String parameter.

이 작업에 대한 중간 빌드 상태를 저장할 위치를 나타내는 파일 이름을 지정합니다.Specifies a file name that indicates where to save the intermediate build state for this task.
SuggestedRedirects 선택적 ITaskItem[] 읽기 전용 출력 매개 변수입니다.Optional ITaskItem[] read-only output parameter.

AutoUnify 매개 변수의 값과 관계없이 충돌하는 모든 고유 어셈블리 ID에 대해 하나의 항목을 포함합니다.Contains one item for every distinct conflicting assembly identity, regardless of the value of the AutoUnify parameter. 여기에는 응용 프로그램 구성 파일에 적합한 bindingRedirect 항목이 없는 것으로 나타난 모든 culture 및 PKT가 포함됩니다.This includes every culture and PKT that was found that did not have a suitable bindingRedirect entry in the application configuration file.

각 항목에는 다음 정보가 들어 있습니다.Each item optionally contains the following information:

- Include 특성: 버전 필드 값이 0.0.0.0인 어셈블리 제품군의 전체 이름을 포함합니다.- Include attribute: Contains the full name of the assembly family with a Version field value of 0.0.0.0
- MaxVersion 항목 메타데이터: 최대 버전 번호를 포함합니다.- MaxVersion item metadata: Contains the maximum version number.
TargetedRuntimeVersion 선택적 String 매개 변수입니다.Optional String parameter.

2.0.57027 또는 v2.0.57027과 같이 런타임 버전을 대상으로 지정합니다.Specifies the runtime version to target, for example, 2.0.57027 or v2.0.57027.
TargetFrameworkDirectories 선택적 String[] 매개 변수입니다.Optional String[] parameter.

대상 프레임워크 디렉터리의 경로를 지정합니다.Specifies the path of the target framework directory. 이 매개 변수는 결과 항목에 대한 CopyLocal 상태를 결정하는 데 필요합니다.This parameter is required to determine the CopyLocal status for resulting items.

이 매개 변수를 지정하지 않는 경우, 결과 항목의 원본 항목에 true 라는 Private 메타데이터 값이 명시적으로 포함되지 않는 한 true 라는 CopyLocal 값이 있는 결과 항목은 존재하지 않게 됩니다.If this parameter is not specified, no resulting items will be have a CopyLocal value of true unless they explicitly have a Private metadata value of true on their source item.
TargetFrameworkMoniker 선택적 String 매개 변수입니다.Optional String parameter.

있을 경우 TargetFrameworkMoniker가 모니터링합니다.The TargetFrameworkMoniker to monitor, if any. 로깅에 사용됩니다.This is used for logging.
TargetFrameworkMonikerDisplayName 선택적 String 매개 변수입니다.Optional String parameter.

있을 경우 모니터링하는 TargetFrameworkMoniker의 표시 이름입니다.The display name of the TargetFrameworkMoniker to monitor, if any. 로깅에 사용됩니다.This is used for logging.
TargetFrameworkSubsets 선택적 String[] 매개 변수입니다.Optional String[] parameter.

대상 프레임워크 디렉터리에서 검색할 대상 프레임워크 하위 집합 이름의 목록을 포함합니다.Contains a list of target framework subset names to be searched for in the target framework directories.
TargetFrameworkVersion 선택적 String 매개 변수입니다.Optional String parameter.

프로젝트 대상 프레임워크 버전입니다.The project target framework version. 기본값은 비어 있으며 이것은 대상 프레임워크를 기반으로 하는 참조에 대한 필터링이 없음을 의미합니다.The default value is empty, which means there is no filtering for the references based on target framework.
TargetProcessorArchitecture 선택적 String 매개 변수입니다.Optional String parameter.

기본 대상 프로세서 아키텍처입니다.The preferred target processor architecture. GAC(전역 어셈블리 캐시) 참조를 확인하는 데 사용됩니다.Used for resolving Global Assembly Cache (GAC) references.

이 매개 변수는 값 x86, IA64 또는 AMD64를 가질 수 있습니다.This parameter can have a value of x86, IA64 or AMD64.

이 매개 변수가 없는 경우, 작업에서는 현재 실행 중인 프로세스의 아키텍처와 일치하는 어셈블리를 먼저 고려합니다.If this parameter is absent, the task first considers assemblies that match the architecture of the currently running process. 어셈블리가 없는 경우 작업에서는 ProcessorArchitectureMSIL 값이 있거나 ProcessorArchitecture 값이 없는 GAC에 있는 어셈블리를 고려합니다.If no assembly is found, the task considers assemblies in the GAC that have ProcessorArchitecture value of MSIL or no ProcessorArchitecture value.

경고Warnings

다음 경고가 기록됩니다.The following warnings are logged:

  • ResolveAssemblyReference.TurnOnAutoGenerateBindingRedirects

  • ResolveAssemblyReference.SuggestedRedirects

  • ResolveAssemblyReference.FoundConflicts

  • ResolveAssemblyReference.AssemblyFoldersExSearchLocations

  • ResolveAssemblyReference.UnifiedPrimaryReference

  • ResolveAssemblyReference.PrimaryReference

  • ResolveAssemblyReference.UnifiedDependency

  • ResolveAssemblyReference.UnificationByAutoUnify

  • ResolveAssemblyReference.UnificationByAppConfig

  • ResolveAssemblyReference.UnificationByFrameworkRetarget

설명Remarks

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

참고 항목See Also

작업 Tasks
작업 참조Task Reference