次の方法で共有


ResolveAssemblyReference タスク

指定したアセンブリに依存するすべてのアセンブリを決定します。これには、2 番目および n 番目の依存関係も含まれます。

パラメーター

ResolveAssemblyReference タスクのパラメーターの説明を次の表に示します。

パラメーター

Description

AllowedAssemblyExtensions

省略可能な String[] 型のパラメーターです。

参照の解決時に使用するアセンブリ ファイル名拡張子。既定のファイル名拡張子は、.exe および .dll です。

AllowedRelatedFileExtensions

省略可能な String[] 型のパラメーターです。

相互に関連するファイルの検索に使用するファイル名拡張子。既定の拡張子は、.pdb および .xml です。

AppConfigFile

省略可能な String 型のパラメーターです。

bindingRedirect マッピングを解析および抽出する元になる app.config を指定します。このパラメーターを指定する場合は、AutoUnify パラメーターを false にする必要があります。

AutoUnify

省略可能な Boolean 型のパラメーターです。

このパラメーターは、標準の App.Config ファイルを持つことができない DLL などのアセンブリのビルドに使用されます。

true の場合、生成される依存グラフは、AppConfigFile パラメーターに渡される App.Config ファイルが存在するものと仮定して自動的に処理されます。この仮想 App.Config ファイルには、最高バージョンのアセンブリが選択されるように、競合するアセンブリ セットごとに bindingRedirect エントリがあります。この結果、すべての競合が解決されるため、競合アセンブリに関する警告は発生しません。

true の場合、再割り当てのたびに高優先度コメントが作成されます。このコメントでは、古いバージョンと新しいバージョンが示され、また AutoUnifytrue であったことが示されます。

true の場合、AppConfigFile パラメーターを空にする必要があります。

false の場合、アセンブリ バージョンの再割り当ては自動的には発生しません。アセンブリの 2 つのバージョンが存在する場合は、警告が発行されます。

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 のバージョンを対象とし、新しいバージョンの .NET Framework 用にコンパイルされたアセンブリを参照する場合、その参照が解決されるのは、SpecificVersion が true に設定されている場合のみです。

    プロジェクトがプロファイルを対象とし、プロファイルにないアセンブリを参照する場合、その参照が解決されるのは、SpecificVersion が true に設定されている場合のみです。

  • ExecutableExtension: String 値。存在する場合、解決されるアセンブリの拡張子はこの値である必要があります。存在しない場合、チェックするディレクトリごとに .dll が最初に考慮され、次に .exe が考慮されます。

  • SubType: String 値。空の SubType メタデータを持つアイテムのみがアセンブリの完全パスに解決されます。空でない SubType メタデータを持つアイテムは無視されます。

  • AssemblyFolderKey: String 値。このメタデータは、レガシ システムで使用できるようにするためにサポートされています。これは、Assemblies がアセンブリ参照を解決するときに使用する必要のある "hklm\VendorFolder" などのユーザー定義のレジストリ キーを指定します。

AssemblyFiles

省略可能な ITaskItem[] 型のパラメーターです。

依存関係を見つける対象の完全修飾アセンブリのリストを指定します。

このパラメーターに渡されるアイテムには、オプションで次のアイテム メタデータを指定できます。

  • Private: 省略可能な Boolean 値。式が true の場合、アイテムはローカルにコピーされます。

  • FusionName: 省略可能な String メタデータ。このアイテムの簡易名または厳密な名前を指定します。この属性が存在する場合、名前を取得するためにアセンブリ ファイルを開く必要がないため、時間を節約できます。

AutoUnify

省略可能な Boolean 型のパラメーターです。

true の場合、生成される依存グラフは、AppConfigFile パラメーターに渡される App.Config ファイルが存在するものと仮定して自動的に処理されます。この仮想 App.Config ファイルには、最高バージョンのアセンブリが選択されるように、競合するアセンブリ セットごとに bindingRedirect エントリがあります。この結果、すべての競合が解決されるため、競合アセンブリに関する警告は発生しません。再割り当てのたびに高優先度コメントが作成されます。このコメントでは、古いバージョンと新しいバージョンが示され、また AutoUnify が true であるためにこの操作が自動的に実行されたことが示されます。

false の場合、アセンブリ バージョンの再割り当ては自動的に発生しません。アセンブリの 2 つのバージョンが存在する場合は、警告が発生します。同じアセンブリの異なるバージョン間に存在する競合ごとに、高優先度コメントが発生します。これらのコメントがすべて表示されると、一意のエラー コードと「同じ依存アセンブリの異なるバージョン間での競合が見つかりました。」というテキストを示す単一の警告が表示されます。

既定値 false です。

CandidateAssemblyFiles

省略可能な String[] 型のパラメーターです。

検索および解決プロセスで使用するアセンブリのリストを指定します。このパラメーターに渡される値は、絶対ファイル名またはプロジェクトの相対ファイル名である必要があります。

SearchPaths パラメーターに、考慮するパスの 1 つとして {CandidateAssemblyFiles} が含まれている場合、このリストのアセンブリが考慮されます。

CopyLocalDependenciesWhenParentReferenceInGac

省略可能な [Boolean] 型のパラメーターです。

true の場合、依存関係がローカルにコピーされるかどうかを確認するために、実行されるチェックのいずれかで、プロジェクト ファイルの親参照にプライベート メタデータが設定されているかどうかが確認されます。メタデータが設定されている場合は、そのプライベートの値が依存関係として使用されます。

メタデータが設定されていない場合、依存関係では、親参照と同じチェックが実行されます。これらのチェックの 1 つでは、その参照が GAC に存在するかどうかを確認します。参照が GAC に存在する場合、コピー先のコンピューターの GAC に存在すると見なされるため、ローカルにコピーされません。これは特定の参照だけに当てはまり、依存関係には当てはまりません。

たとえば、GAC に存在するプロジェクト ファイルの参照はローカルにコピーされませんが、その依存関係は GAC に存在しないためローカルにコピーされます。

false の場合、プロジェクト ファイルの参照が GAC に存在するかどうかがチェックされ、必要に応じてローカルにコピーされます。

依存関係が GAC に存在するかどうかがチェックされ、プロジェクト ファイルからの親参照が GAC に存在するかどうかもチェックされます。

プロジェクト ファイルからの親参照が GAC に存在する場合、依存関係はローカルにコピーされません。

このパラメーターが true また false のいずれであっても、複数の親参照が存在し、そのいずれも GAC に存在していない場合は、それらすべてがローカルにコピーされます。

CopyLocalFiles

省略可能な ITaskItem[] 型の読み取り専用出力パラメーターです。

ResolvedFilesResolvedDependencyFilesRelatedFilesSatelliteFiles、および ScatterFiles パラメーターの各ファイルのうち、CopyLocal アイテム メタデータの値が true であるファイルを返します。

FilesWritten

省略可能な ITaskItem[] 型の出力パラメーター。

ディスクに書き込まれるアイテムが含まれます。

FindDependencies

省略可能な Boolean 型のパラメーターです。

true である場合、依存関係が検索されます。それ以外の場合は、プライマリ参照のみが検索されます。既定値は true です。

FindRelatedFiles

省略可能な Boolean 型のパラメーターです。

true の場合、.pdb ファイルや .xml ファイルなどの関連ファイルが検索されます。既定値は true です。

FindSatellites

省略可能な Boolean 型のパラメーターです。

true の場合、サテライト アセンブリが検索されます。既定値は true. です。

FindSerializationAssemblies

省略可能な Boolean 型のパラメーターです。

true の場合、シリアル化アセンブリが検索されます。既定値は true です。

FullFrameworkAssemblyTables

省略可能な ITaskItem[] 型のパラメーターです。

"FrameworkDirectory" メタデータを持つアイテムを指定して、再頒布リストと特定のフレームワーク ディレクトリを関連付けます。関連付けが行われていない場合は、エラーがログに記録されます。アセンブリ参照の解決 (RAR: Resolve Assembly Reference) のロジックでは、FrameworkDirectory が設定されていない場合、ターゲット フレームワーク ディレクトリが使用されます。

FullFrameworkFolders

省略可能な [String][] 型のパラメーターです。

RedistList ディレクトリが含まれる一連のフォルダーを指定します。このディレクトリは、指定されたクライアント プロファイルのフレームワーク全体を表します (たとえば、%programfiles%\reference assemblies\microsoft\framework\v4.0)。

FullTargetFrameworkSubsetNames

省略可能な String[] 型のパラメーターです。

ターゲット フレームワークのサブセット名のリストが含まれます。リスト内のサブセット名が TargetFrameworkSubset 名プロパティ内の名前と一致する場合、ビルド時にその特定のターゲット フレームワーク サブセットが除外されます。

IgnoreDefaultInstalledAssemblyTables

省略可能な Boolean 型のパラメーターです。

true の場合、TargetFrameworkDirectories の下の \RedistList ディレクトリにある、インストールされた追加のアセンブリ テーブル (または "再頒布リスト") が検索され、使用されます。既定値は false. です。

IgnoreDefaultInstalledAssemblySubsetTables

省略可能な Boolean 型のパラメーターです。

true の場合、TargetFrameworkDirectories の下の \SubsetList ディレクトリにある、インストールされた追加のアセンブリ サブセット テーブル (または "サブセット リスト") が検索され、使用されます。既定値は false. です。

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[] 型のパラメーターです。

コンピューター上で対象にすることができる最新のフレームワークの再領布リストを含むディレクトリの一覧を指定します。これが設定されていない場合、指定されたターゲット フレームワーク識別子についてコンピューターにインストールされている最上位のフレームワークが使用されます。

ProfileName

省略可能な [String] 型のパラメーターです。

  • 対象となるフレームワーク プロファイルの名前を指定します。たとえば、クライアント、Web、またはネットワークです。

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 値。このファイルを解決したリテラル検索パスを指定します。

SatelliteFiles

省略可能な ITaskItem[] 型の読み取り専用出力パラメーターです。

見つかったサテライト ファイルを指定します。このアイテムが存在する原因となった参照または依存関係が CopyLocal=true の場合、これらのパラメーターは CopyLocal=true となります。

このパラメーターのアイテムには、オプションで次のアイテム メタデータを含めることができます。

  • CopyLocal: Boolean 値。指定された参照を出力ディレクトリにコピーする必要があるかどうかを示します。このアイテムが存在する原因となった参照または依存関係の CopyLocal の値が true の場合、この値は true となります。

  • DestinationSubDirectory: String 値。このアイテムのコピー先の相対ディレクトリを指定します。

ScatterFiles

省略可能な ITaskItem[] 型の読み取り専用出力パラメーターです。

指定されたアセンブリの 1 つに関連付けられた scatter ファイルが含まれています。

このパラメーターのアイテムには、オプションで次のアイテム メタデータを含めることができます。

  • CopyLocal: Boolean 値。指定された参照を出力ディレクトリにコピーする必要があるかどうかを示します。

SearchPaths

必須の String[] 型のパラメーターです。

アセンブリを表すディスクのファイルを見つけるために検索されるディレクトリまたは特別な場所を指定します。一覧に検索パスを並べる順序は重要です。各アセンブリに対して、パスのリストは左から右に検索されます。アセンブリを表すファイルが見つかると、検索は停止し、次のアセンブリの検索を開始します。

このパラメーターには、次の型の値を指定できます。

  • ディレクトリ パス。

  • {HintPathFromItem}: 基本アイテムの HintPath メタデータをチェックするように指定します。

  • {CandidateAssemblyFiles}: CandidateAssemblyFiles パラメーターによって渡されたファイルをチェックするように指定します。

  • {Registry:_AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}:

  • {AssemblyFolders}: レジストリからアセンブリを検索する Visual Studio .NET 2003 のスキームを使用するように指定します。

  • {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 属性: Version フィールドの値が 0.0.0.0 であるアセンブリ ファミリの完全名が含まれます。

  • MaxVersion アイテム メタデータ: 最大バージョン番号が含まれます。

TargetedRuntimeVersion

省略可能な String 型のパラメーターです。

ターゲットのランタイム バージョン (たとえば、2.0.57027 または v2.0.57027) を指定します。

TargetFrameworkDirectories

省略可能な String[] 型のパラメーターです。

ターゲット フレームワーク ディレクトリのパスを指定します。このパラメーターは、生成されるアイテムの CopyLocal ステータスを決定するために必要です。

このパラメーターが指定されていない場合、そのソース アイテムの Private メタデータ値が明示的に true である場合を除いて、生成されるアイテムの CopyLocal 値は true にはなりません。

TargetFrameworkMoniker

省略可能な String 型のパラメーターです。

監視する TargetFrameworkMoniker です (ある場合)。これは、ログ作成用に使用されます。

TargetFrameworkMonikerDisplayName

省略可能な String 型のパラメーターです。

監視する TargetFrameworkMoniker の表示名です (ある場合)。これは、ログ作成用に使用されます。

TargetFrameworkSubsets

省略可能な String[] 型のパラメーターです。

ターゲット フレームワーク ディレクトリ内で検索されるターゲット フレームワークのサブセット名のリストを含みます。

TargetFrameworkVersion

省略可能な String 型のパラメーターです。

プロジェクトのターゲット フレームワークのバージョンです。既定値は空です。この場合、ターゲット フレームワークに基づく参照のフィルター処理はありません。

TargetProcessorArchitecture

省略可能な String 型のパラメーターです。

優先されるターゲット プロセッサ アーキテクチャ。グローバル アセンブリ キャッシュ (GAC: Global Assembly Cache) 参照を解決するために使用されます。

このパラメーターの値には、x86IA64、または AMD64 を指定できます。

このパラメーターがない場合、タスクは実行中のプロセスのアーキテクチャに適合するアセンブリを検討します。アセンブリが見つからない場合、タスクは MSIL 値が ProcessorArchitecture の GAC アセンブリまたは ProcessorArchitecture 値がない GAC アセンブリを検討します。

解説

上記のパラメーター以外に、このタスクは TaskExtension クラスからパラメーターを継承します。このクラス自体は、Task クラスから継承されます。これらの追加のパラメーターの一覧とその説明については、「TaskExtension 基本クラス」を参照してください。

参照

概念

MSBuild タスク

その他の技術情報

MSBuild タスク リファレンス