ResolveComReference タスク

1 つ以上のタイプ ライブラリ名または .tlb ファイルから成る一覧を使用して、これらのタイプ ライブラリのディスク上の位置を解決します。

パラメーター

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

パラメーター	説明
DelaySign	省略可能な Boolean 型のパラメーターです。 true の場合、公開鍵がアセンブリに配置されます。 false の場合、アセンブリに完全署名されます。
EnvironmentVariables	省略可能な String[] 型のパラメーターです。 等号で区切られた環境変数のペアの配列です。 これらの変数は、標準の環境ブロックに加え (または標準の環境ブロックを選択的にオーバーライドして)、子の tlbimp.exe および aximp.exe に渡されます。
ExecuteAsTool	省略可能な Boolean 型のパラメーターです。 true の場合、アウトプロセスで適切なターゲット フレームワークの tlbimp.exe および aximp.exe が実行されて、必要なラッパー アセンブリが生成されます。 このパラメーターはマルチ ターゲットを有効にします。
IncludeVersionInInteropName	省略可能な Boolean 型のパラメーターです。 true の場合、typelib バージョンはラッパー名に含まれます。 既定値は、false です。
KeyContainer	省略可能な String 型のパラメーターです。 公開キーと秘密キーのペアを保持するコンテナーを指定します。
KeyFile	省略可能な String 型のパラメーターです。 公開キーと秘密キーのペアを含む項目を指定します。
NoClassMembers	省略可能な Boolean 型のパラメーターです。
ResolvedAssemblyReferences	省略可能な ITaskItem[] 型の出力パラメーターです。 解決されたアセンブリ参照を指定します。
ResolvedFiles	省略可能な ITaskItem[] 型の出力パラメーターです。 このタスクの入力として指定されたタイプ ライブラリの物理的な位置に対応するディスク上の完全修飾ファイルを指定します。
ResolvedModules	省略可能な ITaskItem[] 型のパラメーターです。
SdkToolsPath	省略可能な System.String 型のパラメーターです。 ExecuteAsTool が true の場合、このパラメーターを、対象となっているフレームワークのバージョンの SDK ツール パスに設定する必要があります。
StateFile	省略可能な String 型のパラメーターです。 COM コンポーネントのタイムスタンプのキャッシュ ファイルを指定します。 存在しない場合は、実行するたびにすべてのラッパーが再生成されます。
TargetFrameworkVersion	省略可能な String 型のパラメーターです。 プロジェクトのターゲット フレームワークのバージョンを指定します。 既定値は、String.Empty です。 その場合、ターゲット フレームワークに基づく参照のフィルター処理はありません。
TargetProcessorArchitecture	省略可能な String 型のパラメーターです。 優先されるターゲットのプロセッサ アーキテクチャを指定します。 変換後、tlbimp.exe/machine フラグに渡されます。 パラメーター値は ProcessorArchitecture のメンバーである必要があります。
TypeLibFiles	省略可能な ITaskItem[] 型のパラメーターです。 COM 参照へのタイプ ライブラリ ファイル パスを指定します。 このパラメーターに含まれる項目には、項目のメタデータが含まれます。 詳細については、後述する「TypeLibFiles 項目メタデータ」を参照してください。
TypeLibNames	省略可能な ITaskItem[] 型のパラメーターです。 解決するタイプ ライブラリ名を指定します。 このパラメーターに含まれる項目には、項目メタデータをいくつか含める必要があります。 詳細については、後述する「TypeLibNames 項目メタデータ」を参照してください。
WrapperOutputDirectory	省略可能な String 型のパラメーターです。 生成された相互運用機能アセンブリが配置されるディスク上の場所。 この項目メタデータが指定されていない場合、タスクはプロジェクト ファイルがあるディレクトリの絶対パスを使用します。

TypeLibNames 項目メタデータ

次の表に、TypeLibNames パラメーターに渡された項目に使用可能な項目メタデータを示します。

Metadata	説明
GUID	必要な項目メタデータです。 タイプ ライブラリの GUID。 この項目メタデータが指定されていないと、タスクが失敗します。
VersionMajor	必要な項目メタデータです。 タイプ ライブラリのメジャー バージョンです。 この項目メタデータが指定されていないと、タスクが失敗します。
VersionMinor	必要な項目メタデータです。 タイプ ライブラリのマイナー バージョンです。 この項目メタデータが指定されていないと、タスクが失敗します。
EmbedInteropTypes	省略可能な Boolean メタデータ。 true の場合は、相互運用 DLL を生成するのではなく、この参照から直接アセンブリに相互運用機能型を埋め込みます。
LocaleIdentifier	省略可能な項目メタデータです。 タイプ ライブラリのロケール識別子 (LCID) です。 これは、ユーザー、リージョン、またはアプリケーションで優先される人間の言語を識別する 32 ビット値として指定されます。 この項目メタデータが指定されていないと、タスクは "0" の既定のロケール識別子を使用します。
WrapperTool	省略可能な項目メタデータです。 このタイプ ライブラリのアセンブリ ラッパーを生成するために使用されるラッパー ツールを指定します。 この項目メタデータが指定されていないと、タスクは、"tlbimp" の既定のラッパー ツールを使用します。 使用可能な大文字と小文字を区別しない typelibs の選択肢は次のとおりです。 - Primary: COM コンポーネントの既に生成されたプライマリ相互運用機能アセンブリを使用する場合には、このラッパー ツールを使用します。 このラッパー ツールを使用する場合は、ラッパーの出力ディレクトリを指定しないでください。指定すると、タスクが失敗します。 - TLBImp: COM コンポーネントの相互運用機能アセンブリを作成する場合には、このラッパー ツールを使用します。 - PrimaryOrTLBImp: Primary または TLBImp が適切かどうかが不明な場合は、このラッパー ツールを使用します。 Primary ロジックが最初に適用され、次に TLBImp が適用されます。 - AXImp: ActiveX コントロールの相互運用機能アセンブリを作成する場合には、このラッパー ツールを使用します。

TypeLibFiles 項目メタデータ

次の表に、TypeLibFiles パラメーターに渡された項目に使用可能な項目メタデータを示します。

Metadata	説明
EmbedInteropTypes	省略可能な Boolean 型のパラメーターです。 true の場合は、相互運用 DLL を生成するのではなく、この参照から直接アセンブリに相互運用機能型を埋め込みます。
WrapperTool	省略可能な項目メタデータです。 このタイプ ライブラリのアセンブリ ラッパーを生成するために使用されるラッパー ツールを指定します。 この項目メタデータが指定されていないと、タスクは、"tlbimp" の既定のラッパー ツールを使用します。 使用可能な大文字と小文字を区別しない typelibs の選択肢は次のとおりです。 - Primary: COM コンポーネントの既に生成されたプライマリ相互運用機能アセンブリを使用する場合には、このラッパー ツールを使用します。 このラッパー ツールを使用する場合は、ラッパーの出力ディレクトリを指定しないでください。指定すると、タスクが失敗します。 - TLBImp: COM コンポーネントの相互運用機能アセンブリを作成する場合には、このラッパー ツールを使用します。 - AXImp: ActiveX コントロールの相互運用機能アセンブリを作成する場合には、このラッパー ツールを使用します。

Note

タイプ ライブラリを一意に識別するために提供する情報が多いほど、タスクがディスク上の正しいファイルに解決される可能性が大きくなります。

解説

上記のパラメーターに加えて、このタスクは Task クラスからパラメーターを継承します。 これらの追加パラメーターのリストとその説明については、「Task 基底クラス」を参照してください。

このタスクを機能させるために、COM DLL をコンピューターに登録する必要はありません。

MSB4803 エラー

dotnet CLI コマンドから ResolveCOMReference タスクを使用するプロジェクトを実行しようとすると、次のエラーが発生します。

MSB4803: The task "ResolveComReference" is not supported on the .NET Core version of MSBuild. Please use the .NET Framework version of MSBuild.

このタスクは、MSBuild の .NET Core バージョンではサポートされていません。これは、コマンド ラインから dotnet build コマンドを実行するときに使用されるものです。 Visual Studio 開発者コマンド プロンプトから MSBuild.exe を呼び出してプロジェクトをビルドしてみてください。これには MSBuild の .NET Framework バージョンが使用されるためです。

関連項目

• タスク
• タスク リファレンス