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. アセンブリの 2 つのバージョンが存在する場合は、警告が発行されます。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. これらのコメントの後に、1 つの警告が発行されます。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. これは、 SearchPaths パラメーターに {HintPathFromItem} を指定した場合に使用されます。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 属性は、解決されるアセンブリの完全なフュージョン名である必要があります。When used with a Reference item type, the Include attribute needs to be the full fusion name of the assembly to be resolved. アセンブリが解決されるのは、フュージョンが Include 属性と完全に一致する場合のみです。The assembly is only resolved if fusion exactly matches the Include attribute.
プロジェクトが .NET Framework の 1 つのバージョンを対象とし、それより新しいバージョンの .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. これは、アセンブリ参照を解決するために Assemblies が使用する必要のあるユーザー定義のレジストリ キー ("hklm\VendorFolder" など) を指定します。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. アセンブリの 2 つのバージョンが存在する場合は、警告が発生します。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. これらすべてのコメントが表示された後、一意のエラー コードと「参照アセンブリと依存アセンブリの異なるバージョン間での競合が見つかりました」というテキストが含まれる 1 つの警告が発行されます。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 パラメーターに、考慮するパスの 1 つとして {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 の場合、依存関係をローカルにコピーする必要があるかどうかを確認するために、実行されるチェックのいずれかで、プロジェクト ファイルの親参照に Private メタデータが設定されているかどうかが確認されます。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. メタデータが設定されている場合は、Private 値が依存関係として使用されます。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. これらのチェックの 1 つでは、その参照が 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.

ResolvedFilesResolvedDependencyFilesRelatedFilesSatelliteFilesScatterFiles の各パラメーターに指定されたファイルのうち、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の場合、シリアル化アセンブリが検索されます。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. アセンブリ参照の解決 (RAR) ロジックでは、FrameworkDirectory が設定されていない場合、ターゲット フレームワーク ディレクトリが使用されます。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 名前プロパティにある名前の 1 つと一致する場合、ビルド時にその特定のターゲット フレームワーク サブセットが除外されます。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.

必要に応じて、この一覧に含まれるアイテムは "FrameworkDirectory" メタデータを指定して InstalledAssemblySubsetTableAs an option, items in this list can specify the "FrameworkDirectory" metadata to associate an InstalledAssemblySubsetTable

特定のフレームワーク ディレクトリに関連付けることができます。with a particular framework directory.

TargetFrameworkDirectories 要素が 1 つだけの場合、この一覧に含まれるアイテムのうち "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.

必要に応じて、この一覧に含まれるアイテムで "FrameworkDirectory" メタデータを指定して InstalledAssemblyTable を特定のフレームワーク ディレクトリに関連付けることができます。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 要素が 1 つだけの場合、この一覧に含まれるアイテムのうち "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. このパラメーターには、1 番目のプライマリ参照は含まれていません。1 番目の参照は 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 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.

指定されたアセンブリの 1 つに関連付けられた scatter ファイルが含まれています。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 シリアル化アセンブリが格納されます。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 パラメーターの値にかかわらず、すべての別個の競合アセンブリごとに 1 つのアイテムが含まれます。Contains one item for every distinct conflicting assembly identity, regardless of the value of the AutoUnify parameter. これには、アプリケーション構成ファイルに適切な bindingRedirect エントリが存在しないことが判明したすべてのカルチャと 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 属性: Version フィールドの値が 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 true Private である場合を除いて、生成されるアイテムの CopyLocal 値は true にはなりません。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.

このパラメーターの値には、 x86IA64 、または 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. そのようなアセンブリが見つからない場合は、 ProcessorArchitecture 値が MSIL である GAC 内のアセンブリ、または 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

上記のパラメーター以外に、このタスクは TaskExtension クラスからパラメーターを継承します。このクラス自体は、Task クラスから継承されます。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 (タスク リファレンス)Task Reference