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 |
省略可能な [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 パラメーターに渡される項目で利用できる項目メタデータの説明を次の表に示します。
メタデータ |
説明 |
|---|---|
GUID |
必須項目メタデータ。 タイプ ライブラリの GUID。この項目メタデータが指定されていない場合、タスクは失敗します。 |
VersionMajor |
必須項目メタデータ。 タイプ ライブラリのメジャー バージョン。この項目メタデータが指定されていない場合、タスクは失敗します。 |
VersionMinor |
必須項目メタデータ。 タイプ ライブラリのマイナー バージョン。この項目メタデータが指定されていない場合、タスクは失敗します。 |
LocaleIdentifier |
省略可能な項目メタデータ。 タイプ ライブラリのロケール識別子 (LCID)。32 ビット値で指定され、ユーザー、地域、またはアプリケーションで優先される言語を表します。この項目メタデータが指定されていない場合、タスクでは既定のロケール識別子 "0" が使用されます。 |
WrapperTool |
省略可能な項目メタデータ。 このタイプ ライブラリのアセンブリ ラッパーを生成するためのラッパー ツールを指定します。この項目メタデータが指定されていない場合、タスクでは既定のラッパー ツール "tlbimp" が使用されます。利用できる typelib (大文字と小文字を区別しない) は次のとおりです。
|
TypeLibFiles 項目メタデータ
TypeLibFiles パラメーターに渡される項目で利用できる項目メタデータの説明を次の表に示します。
メタデータ |
説明 |
|---|---|
WrapperTool |
省略可能な項目メタデータ。 このタイプ ライブラリのアセンブリ ラッパーを生成するためのラッパー ツールを指定します。この項目メタデータが指定されていない場合、タスクでは既定のラッパー ツール "tlbimp" が使用されます。利用できる typelib (大文字と小文字を区別しない) は次のとおりです。
|
[!メモ]
タイプ ライブラリを一意に識別するための情報が増えると、タスクがディスク上の正しいファイルを解決できる可能性が高くなります。
解説
上記のパラメーター以外に、このタスクは Task クラスからパラメーターを継承します。これらの追加のパラメーターの一覧とその説明については、「Task 基本クラス」を参照してください。