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

ExecuteAsTooltrue の場合、このパラメーターを、対象となっているフレームワークのバージョンの 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 パラメーターに渡された項目に使用可能な項目メタデータを示します。

メタデータ 説明
GUID 必要な項目メタデータです。

タイプ ライブラリの GUID。 この項目メタデータが指定されていないと、タスクが失敗します。
VersionMajor 必要な項目メタデータです。

タイプ ライブラリのメジャー バージョンです。 この項目メタデータが指定されていないと、タスクが失敗します。
VersionMinor 必要な項目メタデータです。

タイプ ライブラリのマイナー バージョンです。 この項目メタデータが指定されていないと、タスクが失敗します。
LocaleIdentifier 省略可能な項目メタデータです。

タイプ ライブラリのロケール識別子 (LCID) です。 これは、ユーザー、リージョン、またはアプリケーションで優先される人間の言語を識別する 32 ビット値として指定されます。 この項目メタデータが指定されていないと、タスクは "0" の既定のロケール識別子を使用します。
WrapperTool 省略可能な項目メタデータです。

このタイプ ライブラリのアセンブリ ラッパーを生成するために使用されるラッパー ツールを指定します。 この項目メタデータが指定されていないと、タスクは、"tlbimp" の既定のラッパー ツールを使用します。 使用可能な大文字と小文字を区別しない typelibs の選択肢は次のとおりです。

- Primary: COM コンポーネントの既に生成されたプライマリ相互運用機能アセンブリを使用する場合には、このラッパー ツールを使用します。 このラッパー ツールを使用する場合は、ラッパーの出力ディレクトリを指定しないでください。指定すると、タスクが失敗します。
- TLBImp: COM コンポーネントの相互運用機能アセンブリを作成する場合には、このラッパー ツールを使用します。
- AXImp: ActiveX コントロールの相互運用機能アセンブリを作成する場合には、このラッパー ツールを使用します。

TypeLibFiles 項目メタデータ

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

メタデータ 説明
WrapperTool 省略可能な項目メタデータです。

このタイプ ライブラリのアセンブリ ラッパーを生成するために使用されるラッパー ツールを指定します。 この項目メタデータが指定されていないと、タスクは、"tlbimp" の既定のラッパー ツールを使用します。 使用可能な大文字と小文字を区別しない typelibs の選択肢は次のとおりです。

- Primary: COM コンポーネントの既に生成されたプライマリ相互運用機能アセンブリを使用する場合には、このラッパー ツールを使用します。 このラッパー ツールを使用する場合は、ラッパーの出力ディレクトリを指定しないでください。指定すると、タスクが失敗します。
- TLBImp: COM コンポーネントの相互運用機能アセンブリを作成する場合には、このラッパー ツールを使用します。
- AXImp: ActiveX コントロールの相互運用機能アセンブリを作成する場合には、このラッパー ツールを使用します。
注意

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

コメント

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

関連項目

タスク
Task Reference (タスク リファレンス)