ResolveComReference タスク

更新 : 2007 年 11 月

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

パラメータ

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

パラメータ

説明

DelaySign

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

true に設定すると、アセンブリに公開キーが格納されます。false に設定すると、アセンブリに完全な署名が行われます。

KeyContainer

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

キー ペアを保持するコンテナを指定します。

KeyFile

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

キー ペアを含む項目を指定します。

NoClassMembers

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

ResolvedAssemblyReferences

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

解決されたアセンブリ参照を指定します。

ResolvedFiles

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

このタスクの入力として指定されたタイプ ライブラリについて、その物理的な位置に対応するディスク上の完全修飾ファイルを指定します。

ResolvedModules

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

TypeLibFiles

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

COM 参照に対するタイプ ライブラリ ファイル パスを指定します。このパラメータに含まれる項目には、項目メタデータが含まれることがあります。詳細については、後述する「TypeLibFiles 項目 メタデータ」を参照してください。

TypeLibNames

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

解決するタイプ ライブラリ名を指定します。このパラメータに含まれる項目には、項目メタデータを含める必要があります。詳細については、後述する「TypeLibNames 項目メタデータ」を参照してください。

WrapperOutputDirectory

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

生成された相互運用機能アセンブリが格納される、ディスク上の場所。この項目メタデータが指定されていない場合、タスクではプロジェクト ファイルの存在するディレクトリの絶対パスを使用します。

解説

TypeLibNames 項目メタデータ

次の表は、TypeLibNames パラメータに渡される項目で利用できる項目メタデータの説明です。

メタデータ

説明

GUID

必須項目メタデータ。

タイプ ライブラリの GUID。この項目メタデータが指定されていない場合、タスクは失敗します。

VersionMajor

必須項目メタデータ。

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

VersionMinor

必須項目メタデータ。

タイプ ライブラリのマイナー バージョン。この項目メタデータが指定されていない場合、タスクは失敗します。

LocaleIdentifier

省略可能な項目メタデータ。

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

WrapperTool

省略可能な項目メタデータ。

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

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

  • TLBImp : COM コンポーネントの相互運用機能アセンブリを生成する場合は、このラッパー ツールを使用します。

  • AXImp : ActiveX コンポーネントの相互運用機能アセンブリを生成する場合は、このラッパー ツールを使用します。

TypeLibFiles 項目メタデータ

次の表は、TypeLibFiles パラメータに渡される項目で利用できる項目メタデータの説明です。

メタデータ

説明

WrapperTool

省略可能な項目メタデータ。

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

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

  • TLBImp : COM コンポーネントの相互運用機能アセンブリを生成する場合は、このラッパー ツールを使用します。

  • AXImp : ActiveX コンポーネントの相互運用機能アセンブリを生成する場合は、このラッパー ツールを使用します。

56e00bfh.alert_note(ja-jp,VS.90).gifメモ :

タイプ ライブラリを一意に識別するための情報が増えると、タスクがディスク上の正しいファイルを解決できる可能性が高くなります。

参照

概念

MSBuild タスク

その他の技術情報

MSBuild タスク リファレンス