ResolveAssemblyReference タスク
指定したアセンブリに依存するすべてのアセンブリを判断します。これには、2 番目と n 番目の依存関係も含まれます。 アセンブリ参照 ビルド エラーのトラブルシューティングも参照してください。
パラメーター
ResolveAssemblyReference タスクのパラメーターの説明を次の表に示します。
| パラメーター | 説明 |
|---|---|
AllowedAssemblyExtensions |
省略可能な String[] 型のパラメーターです。参照を解決するときに使用するアセンブリ ファイル名拡張子。 既定のファイル名拡張子は exe され、 dllされます。 |
AllowedRelatedFileExtensions |
省略可能な String[] 型のパラメーターです。相互に関連するファイルの検索に使用するファイル名拡張子。 既定の拡張機能は pdb と xmlです。 |
AppConfigFile |
省略可能な String 型のパラメーターです。bindingRedirect マッピングを解析および抽出する元になる app.config ファイルを指定します。 このパラメーターを指定する場合は、 AutoUnify パラメーターを falseにする必要があります。 |
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にする必要があります。参照項目型と共に使用する場合、 Include 属性は、解決されるアセンブリの完全なフュージョン名である必要があります。 アセンブリが解決されるのは、フュージョンが Include 属性と完全に一致する場合のみです。プロジェクトが .NET Framework の 1 つのバージョンを対象とし、それより新しいバージョンの .NET Framework 用にコンパイルされたアセンブリを参照している場合、その参照が解決されるのは、 SpecificVersion が trueにする必要があります。プロジェクトがプロファイルを対象とし、プロファイルに含まれていないアセンブリを参照する場合、参照は trueに設定SpecificVersion場合にのみ解決されます。- ExecutableExtension: String 値。 存在する場合、解決されるアセンブリの拡張子はこの値である必要があります。 存在しない場合、 dll は最初に考慮され、その後に調べられたディレクトリごとに .exeが続きます。- SubType: String 値。 空の SubType メタデータを持つ項目のみが完全なアセンブリ パスに解決されます。 メタデータが空でないアイテム SubType は無視されます。- AssemblyFolderKey: String 値。 古いバージョンとの互換性の目的でサポートされるメタデータです。 これは、アセンブリ参照を解決するために Assemblies が使う必要のあるユーザー定義のレジストリ キー (hklm\<VendorFolder> など) を指定します。 |
AssemblyFiles |
省略可能な ITaskItem[] 型のパラメーターです。依存関係を見つける対象の完全修飾アセンブリの一覧を指定します。 このパラメーターに渡されるアイテムには、必要に応じて、次のアイテム メタデータを指定できます。 - Private: 省略可能な Boolean 値。 true の場合、アイテムはローカルにコピーされます。- FusionName: 省略可能な String メタデータ。 このアイテムの簡易名または厳密な名前を指定します。 この属性が存在する場合、名前を取得するためにアセンブリ ファイルを開く必要がないため、時間を節約できます。 |
AssemblyInformationCacheOutputPath |
省略可能な String 型のパラメーターです。null でない場合は、AssemblyFiles 入力に関するマシンに依存しない情報を、名前付きファイルにシリアル化します。 この設定は通常のキャッシュをオーバーライドするため、多くの参照を含む SDK を構築していて、顧客にキャッシュを発送する場合にのみ、この設定を使用します。 |
AssemblyInformationCachePaths |
省略可能な ITaskItem 型のパラメーターです。 null でない場合は、MSBuild が obj フォルダー内の通常のキャッシュを見つけることができない場合は、この一連のキャッシュを入力として使用します。 通常、最初のビルドのパフォーマンスを向上させるために SDK によって提供されます。 |
AutoUnify |
省略可能な Boolean 型のパラメーターです。このパラメーターは、通常の App.Config ファイルを持つことができない DLL などのアセンブリを構築するために使用されます。 true の場合、生成される依存関係グラフは、AppConfigFile パラメーターに渡される App.Config ファイルが存在するものと仮定して自動的に処理されます。 この仮想 App.Config ファイルには、競合するアセンブリ セットごとに bindingRedirect エントリがあるので、最高バージョンのアセンブリが選択されます。 この結果、すべての競合が解決されるため、競合アセンブリに関する警告は発生しません。trueすると、各個別の再マップによって、古いバージョンと新しいバージョンが示され、AutoUnifyがtrueされたことを示す優先度の高いコメントが表示されます。trueする場合、AppConfigFile パラメーターは空である必要があります。falseの場合、アセンブリ バージョンの再割り当ては自動的には発生しません。 アセンブリの 2 つのバージョンが存在する場合は、警告が発行されます。falseの場合、同じアセンブリの異なるバージョン間に競合が発生するたびに、高優先度コメントが発行されます。 これらのコメントの後に、1 つの警告が発行されます。 警告には一意のエラー コードがあり、"参照アセンブリと依存アセンブリの異なるバージョン間で競合が見つかりました" というテキストが含まれています。既定値は false です。 |
CandidateAssemblyFiles |
省略可能な String[] 型のパラメーターです。検索と解決のプロセスで使うアセンブリの一覧を指定します。 このパラメーターに渡す値は、絶対ファイル名またはプロジェクトに対する相対ファイル名である必要があります。 この一覧のアセンブリは、 SearchPaths パラメーターに {CandidateAssemblyFiles} が考慮するパスの 1 つとして含まれている場合に考慮されます。 |
CopyLocalDependenciesWhenParentReferenceInGac |
省略可能な Boolean 型のパラメーターです。 true の場合、依存関係をローカルにコピーする必要があるかどうかを確認するために、実行されるチェックのいずれかで、プロジェクト ファイルの親参照に Private メタデータが設定されているかどうかが確認されます。 メタデータが設定されている場合は、Private 値が依存関係として使用されます。 メタデータが設定されていない場合、依存関係は親参照と同じチェックを行います。 これらのチェックの 1 つでは、その参照が GAC 内にあるかどうかが確認されます。 参照が GAC 内にある場合は、ターゲット コンピューター上の GAC 内にあると見なされるため、ローカルにコピーされません。 これは特定の参照だけに当てはまり、依存関係には当てはまりません。 たとえば、GAC 内のプロジェクト ファイル内の参照はローカルにコピーされませんが、GAC に含まれていないため、その依存関係はローカルにコピーされます。 false の場合、プロジェクト ファイル参照は GAC 内にあるかどうかを確認するためにチェックされ、必要に応じてローカルにコピーされます。 依存関係は GAC 内にあるかどうかを確認するためにチェックされ、プロジェクト ファイルからの親参照が GAC 内にあるかどうかも確認されます。 プロジェクト ファイルの親参照が GAC 内にある場合、依存関係はローカルにコピーされません。 このパラメーターが true か false かにかかわらず、複数の親参照があり、そのうちのいずれかが GAC に含まれていない場合、それらのすべてがローカルにコピーされます。 |
CopyLocalFiles |
省略可能な ITaskItem[] 型の読み取り専用の出力パラメーターです。ResolvedFiles、ResolvedDependencyFiles、RelatedFiles、SatelliteFiles、ScatterFiles の各パラメーターに指定されたファイルのうち、CopyLocal アイテム メタデータの値が true であるファイルを返します。 |
DependsOnNETStandard |
Boolean 出力パラメーターです。 解決されたプライマリ参照のいずれかが .NET Standard に依存するかどうか。 |
DependsOnSystemRuntime |
Boolean 出力パラメーターです。 解決されたプライマリ参照のいずれかが System.Runtime に依存するかどうか。 |
DoNotCopyLocalIfInGac |
省略可能な Boolean 型のパラメーターです。CopyLocal を決定するためにレガシ モードを有効にします。 true の場合、参照されるアセンブリは GAC で見つかった場合、ローカルにコピーされません。 false の場合、アセンブリは GAC でのみ検出されない限り、ローカルにコピーされます。 既定値は false です。 |
FilesWritten |
省略可能な ITaskItem[] 型の出力パラメーターです。ディスクに書き込まれたアイテムが含まれます。 |
FindDependencies |
省略可能な Boolean 型のパラメーターです。true場合、依存関係が見つかります。 それ以外の場合、プライマリ参照のみが検索されます。 既定値は true です。 |
FindDependenciesOfExternallyResolvedReferences |
省略可能な Boolean 型のパラメーターです。参照が ExternallyResolved=true メタデータでマークされている場合でも、依存関係を強制的にウォークします。 |
FindRelatedFiles |
省略可能な Boolean 型のパラメーターです。true場合は、pdbファイルやxmlファイルなどの関連ファイルが見つかります。 既定値は true です。 |
FindSatellites |
省略可能な Boolean 型のパラメーターです。true場合は、サテライト アセンブリが見つかります。 既定値は true. |
FindSerializationAssemblies |
省略可能な Boolean 型のパラメーターです。trueの場合、シリアル化アセンブリが検索されます。 既定値は true です。 |
FullFrameworkAssemblyTables |
省略可能な ITaskItem[] 型のパラメーターです。再リストを特定のフレームワーク ディレクトリに関連付ける FrameworkDirectory メタデータを持つ項目を指定します。 関連付けが行われていない場合は、エラーがログに記録されます。 FrameworkDirectoryが設定されていない場合、解決アセンブリ参照 (RAR) ロジックはターゲット フレームワーク ディレクトリを使用します。 |
FullFrameworkFolders |
省略可能な System.String[] 型のパラメーターです。RedistList ディレクトリが含まれるフォルダーを指定します。 このディレクトリは、特定のクライアント プロファイルのフレームワーク全体を表します (たとえば、%programfiles%\reference assemblies\microsoft\framework\v4.0)。 |
FullTargetFrameworkSubsetNames |
省略可能な String[] 型のパラメーターです。ターゲット フレームワークのサブセット名の一覧が含まれます。 この一覧にあるサブセット名が、 TargetFrameworkSubset 名前プロパティにある名前の 1 つと一致する場合、ビルド時にその特定のターゲット フレームワーク サブセットが除外されます。 |
IgnoreDefaultInstalledAssemblyTables |
省略可能な Boolean 型のパラメーターです。true の場合、TargetFrameworkDirectories の下の \RedistList ディレクトリにある、インストールされた追加のアセンブリ テーブル (または "再頒布リスト") がタスクによって検索され、使用されます。 既定値は false. |
IgnoreDefaultInstalledAssemblySubsetTables |
省略可能な Boolean 型のパラメーターです。true の場合、TargetFrameworkDirectories の下の \SubsetList ディレクトリにある、インストールされた追加のアセンブリ サブセット テーブル (または "サブセット リスト") がタスクによって検索され、使用されます。 既定値は false. |
IgnoreTargetFrameworkAttributeVersionMismatch |
省略可能な Boolean 型のパラメーターです。true場合、タスクは現在のプロジェクトよりも上位の .NET Framework バージョンを対象とするアセンブリを解決します。 既定値は false であり、これらの参照はスキップされます。 |
IgnoreVersionForFrameworkReferences |
省略可能な Boolean 型のパラメーターです。プライマリ参照がフレームワーク アセンブリの場合は、そのバージョン情報を無視し、現在のターゲット フレームワークからフレームワーク アセンブリを実際に解決します。 |
InstalledAssemblySubsetTables |
省略可能な ITaskItem[] 型のパラメーターです。ターゲット サブセットに含められるはずのアセンブリを指定する XML ファイルの一覧を含みます。 オプションとして、このリスト内の項目は、 FrameworkDirectory メタデータを指定して、 InstalledAssemblySubsetTable特定のフレームワーク ディレクトリに関連付けることができます。 TargetFrameworkDirectories要素が 1 つしかない場合、FrameworkDirectory" メタデータがないこのリスト内の項目は、TargetFrameworkDirectoriesに渡される一意の値に設定されているかのように扱われます。 |
InstalledAssemblyTables |
省略可能な String 型のパラメーターです。ターゲット コンピューターにインストールされるはずのアセンブリを指定する XML ファイルの一覧を含みます。 InstalledAssemblyTables が設定されている場合、一覧に含まれる前のバージョンのアセンブリは、XML で指定されている新しい方のバージョンにマージされます。 また、InGAC='true' の設定を持つアセンブリは前提条件と見なされ、明示的にオーバーライドされない限り CopyLocal='false' に設定されます。オプションとして、この一覧の項目では、 FrameworkDirectory メタデータを指定して、 InstalledAssemblyTable を特定のフレームワーク ディレクトリに関連付けることができます。 ただし、この設定は、再頒布名がMicrosoft-Windows-CLRCoreComp.TargetFrameworkDirectories要素が 1 つしかない場合、FrameworkDirectoryメタデータがないこのリスト内の項目は、渡される一意の値に設定されているかのように扱われます。TargetFrameworkDirectoriesに対する呼び出しで返された結果。 |
LatestTargetFrameworkDirectories |
省略可能な String[] 型のパラメーターです。コンピューター上で対象にすることができる最新のフレームワークの再領布リストを含むディレクトリの一覧を指定します。 これが設定されていない場合は、特定のターゲット フレームワーク識別子に対してマシンにインストールされている最も高いフレームワークが使用されます。 |
OutputUnresolvedAssemblyConflicts |
省略可能な Boolean 型のパラメーターです。true の場合は、診断コード MSB3277 と競合している未解決のアセンブリが出力 UnresolveAssemblyConflicts に出力されます。 |
ProfileName |
省略可能な String 型のパラメーターです。対象とするフレームワーク プロファイルの名前を指定します。 たとえば、Client、Web、Network などです。 .NET Framework プロファイルにのみ関連します。 |
RelatedFiles |
省略可能な ITaskItem[] 型の読み取り専用の出力パラメーターです。参照と同じベース名を持つ XML ファイルや pdb ファイルなどの関連ファイルが含まれます。このパラメーターに指定するファイルには、必要に応じて、次のアイテム メタデータを含めることができます。 - Primary: Boolean 値。 trueの場合、ファイル アイテムは Assemblies 型のパラメーターです。 既定値は falseにする必要があります。- CopyLocal: Boolean 値。 指定された参照を出力ディレクトリにコピーする必要があるかどうかを示します。 |
ResolvedDependencyFiles |
省略可能な ITaskItem[] 型の読み取り専用の出力パラメーターです。依存関係への n番目のパスが含まれます。 このパラメーターには、 ResolvedFiles パラメーターに含まれる最初の順序のプライマリ参照は含まれません。このパラメーターに指定するアイテムには、必要に応じて、次のアイテム メタデータを含めることができます。 - CopyLocal: Boolean 値。 指定された参照を出力ディレクトリにコピーする必要があるかどうかを示します。- FusionName: String 値。 この依存関係の名前を指定します。- ResolvedFrom: String 値。 このファイルに解決されたリテラル検索パスを指定します。 |
ResolvedFiles |
省略可能な ITaskItem[] 型の読み取り専用の出力パラメーターです。完全パスに解決されるすべてのプライマリ参照の一覧が含まれます。 このパラメーターに指定するアイテムには、必要に応じて、次のアイテム メタデータを含めることができます。 - CopyLocal: Boolean 値。 指定された参照を出力ディレクトリにコピーする必要があるかどうかを示します。- FusionName: String 値。 この依存関係の名前を指定します。- ResolvedFrom: String 値。 このファイルに解決されたリテラル検索パスを指定します。 |
ResolvedSDKReferences |
省略可能な ITaskItem[] 型のパラメーターです。解決済みの SDK 参照の一覧。SDK 名、SDK の場所、および対象となる構成が含まれます。 これらの場所は、参照に SDKName メタデータがアタッチされている場合にのみ検索されます。 |
SatelliteFiles |
省略可能な ITaskItem[] 型の読み取り専用の出力パラメーターです。見つかったすべてのサテライト ファイルを指定します。 これらのファイルは、この項目が存在する原因となった参照または依存関係が CopyLocal=true場合にCopyLocal=trueされます。このパラメーターに指定するアイテムには、必要に応じて、次のアイテム メタデータを含めることができます。 - CopyLocal: Boolean 値。 指定された参照を出力ディレクトリにコピーする必要があるかどうかを示します。 このアイテムが存在する原因となった参照または依存関係の true true CopyLocal の場合、この値は trueにする必要があります。- DestinationSubDirectory: String 値。 このアイテムのコピー先の相対ディレクトリを指定します。 |
ScatterFiles |
省略可能な ITaskItem[] 型の読み取り専用の出力パラメーターです。指定されたアセンブリの 1 つに関連付けられた scatter ファイルが含まれています。 このパラメーターに指定するアイテムには、必要に応じて、次のアイテム メタデータを含めることができます。 - CopyLocal: Boolean 値。 指定された参照を出力ディレクトリにコピーする必要があるかどうかを示します。 |
SearchPaths |
必須の String[] 型のパラメーターです。アセンブリを表すディスク上のファイルを探すために検索されるディレクトリまたは特別な場所を指定します。 検索パスを指定する順序が重要です。 各アセンブリについて、パスの一覧が左から右に検索されます。 アセンブリを表すファイルが見つかると、検索は停止し、次のアセンブリの検索が始まります。 このパラメーターは、セミコロンで区切られた値のリストを受け入れます。値は、ディレクトリ パスでも、下のリストからの特別なリテラル値でも可能です。 - {HintPathFromItem}: 基本項目の HintPath メタデータを調べるようタスクに指示します。- {CandidateAssemblyFiles}: CandidateAssemblyFiles パラメーターを使用して渡されたファイルを調べるようタスクに指示します。- {Registry:<AssemblyFoldersBase>、 <RuntimeVersion>、 <AssemblyFoldersSuffix>}: レジストリで指定された追加のフォルダーを検索するようにタスクに指示します。 <AssemblyFoldersBase>、<RuntimeVersion>、<AssemblyFoldersSuffix> は、検索されるレジストリの場所を示す特定の値に置き換える必要があります。 一般的なターゲットの既定の場所は {Registry:$(FrameworkRegistryBase), $(TargetFrameworkVersion), $(AssemblyFoldersSuffix), $(AssemblyFoldersExConditions)} です。- {AssemblyFolders}: Visual Studio.NET 2003 finding-assemblies-from-registry スキームを使用するようにタスクに指示します。- {GAC}: グローバル アセンブリ キャッシュ (GAC) で検索するようにタスクに指示します。- {RawFileName}: タスクがアイテムの Include 値を正確なパスとファイル名として考慮するように指定します。 |
SerializationAssemblyFiles |
省略可能な ITaskItem[] 型の読み取り専用の出力パラメーターです。見つかったすべての XML シリアル化アセンブリが格納されます。 このアイテムが存在する原因となった参照または依存関係が CopyLocal=true の場合に限り、これらのアイテムは CopyLocal=true とマークされます。 Boolean メタデータ CopyLocal は、指定された参照を出力ディレクトリにコピーする必要があるかどうかを示します。 |
Silent |
省略可能な Boolean 型のパラメーターです。trueの場合、メッセージはログに記録されません。 既定値は false です。 |
StateFile |
省略可能な String 型のパラメーターです。このタスクの中間ビルド状態の保存場所を示すファイル名を指定します。 |
SuggestedRedirects |
省略可能な ITaskItem[] 型の読み取り専用の出力パラメーターです。AutoUnify パラメーターの値にかかわらず、すべての別個の競合アセンブリごとに 1 つのアイテムが含まれます。 これには、アプリケーション構成ファイルに適切な bindingRedirect エントリがなかったすべてのカルチャと PKT が含まれます。各アイテムには、オプションで、次の情報が含まれています。 - Include attribute: Version フィールド値が ᠒のアセンブリ ファミリの完全な名前が含まれています 0.0.0.0- MaxVersion アイテム メタデータ: 最大バージョン番号が含まれています。 |
SupportsBindingRedirectGeneration |
省略可能な Boolean 型のパラメーターです。サポートされているプロジェクトでこれを true に設定して、バインド リダイレクトを自動的に生成します (現在は EXE プロジェクトでのみサポートされています)。 |
TargetedRuntimeVersion |
省略可能な String 型のパラメーターです。ターゲットにするランタイムのバージョン (たとえば、2.0.57027 または v2.0.57027 など) を指定します。 |
TargetFrameworkDirectories |
省略可能な String[] 型のパラメーターです。ターゲット フレームワーク ディレクトリのパスを指定します。 このパラメーターは、結果のアイテムの CopyLocal 状態を決定するために必要です。このパラメーターが指定されていない場合、ソース アイテムに true のPrivateメタデータ値が明示的に設定されていない限り、結果のアイテムは true のCopyLocal値を持つことはありません。 |
TargetFrameworkMoniker |
省略可能な String 型のパラメーターです。監視する TargetFrameworkMoniker (存在する場合)。 このパラメーターは、ログ記録に使用されます。 |
TargetFrameworkMonikerDisplayName |
省略可能な String 型のパラメーターです。監視する TargetFrameworkMoniker の表示名です (ある場合)。 このパラメーターは、ログ記録に使用されます。 |
TargetFrameworkSubsets |
省略可能な String[] 型のパラメーターです。ターゲット フレームワーク ディレクトリ内で検索するターゲット フレームワークのサブセット名の一覧が含まれます。 |
TargetFrameworkVersion |
省略可能な String 型のパラメーターです。プロジェクトのターゲット フレームワークのバージョンです。 既定値は空です。つまり、ターゲット フレームワークに基づく参照のフィルター処理はありません。 |
TargetProcessorArchitecture |
省略可能な String 型のパラメーターです。優先されるターゲットのプロセッサ アーキテクチャです。 グローバル アセンブリ キャッシュ (GAC) の参照を解決するために使用されます。 このパラメーターの値には、 x86、IA64、または AMD64 を指定できます。このパラメーターがない場合は、最初に、現在実行中のプロセスのアーキテクチャに一致するアセンブリが検討されます。 そのようなアセンブリが見つからない場合は、 ProcessorArchitecture 値が MSIL である GAC 内のアセンブリ、または ProcessorArchitecture 値のない GAC 内のアセンブリが検討されます。 |
UnresolvedAssemblyConflicts |
省略可能な ITaskItem[] 型の読み取り専用の出力パラメーターです。パラメーター OutputUnresolvedAssemblyConflicts が true の場合、これは MSB3277 で通常出力されていた未解決の競合に関する情報の一覧に設定されます。 それ以外の場合は、空です。 |
UnresolveFrameworkAssembliesFromHigherFrameworks |
省略可能な Boolean 型のパラメーターです。true に設定されている場合、バージョンがターゲット フレームワークのバージョン以上のフレームワーク アセンブリは強制的に未解決となります。 |
WarnOrErrorOnTargetArchitectureMismatch |
省略可能な String 型のパラメーターです。ターゲット プロセッサ アーキテクチャとプライマリ参照のアーキテクチャの間に不一致がある場合、これが Errorされるとエラーがログに記録されます。 Warningすると警告がログに記録されます。 Noneすると、エラーや警告はログに記録されません。 既定値は Warning です。 |
警告
次の警告がログに記録されます。
ResolveAssemblyReference.TurnOnAutoGenerateBindingRedirectsResolveAssemblyReference.SuggestedRedirectsResolveAssemblyReference.FoundConflictsResolveAssemblyReference.AssemblyFoldersExSearchLocationsResolveAssemblyReference.UnifiedPrimaryReferenceResolveAssemblyReference.PrimaryReferenceResolveAssemblyReference.UnifiedDependencyResolveAssemblyReference.UnificationByAutoUnifyResolveAssemblyReference.UnificationByAppConfigResolveAssemblyReference.UnificationByFrameworkRetarget
解説
上記のパラメーター以外に、このタスクは TaskExtension クラスからパラメーターを継承します。このクラス自体は、Task クラスから継承されます。 これらの追加のパラメーターの一覧とその説明については、「TaskExtension Base Class」を参照してください。