タイプ ライブラリのアセンブリとしてのインポート

  • [アーティクル]

通常、COM 型の定義は、タイプ ライブラリに存在します。 これに対し、CLS 準拠のコンパイラはアセンブリ内に型のメタデータを生成します。 型情報の 2 つのソースは大きく異なります。 このトピックでは、タイプ ライブラリからメタデータを生成する方法について説明します。 結果のアセンブリは相互運用機能アセンブリと呼ばれ、含まれる型情報により、.NET Framework アプリケーションで COM 型を使用できます。

この型情報をアプリケーションに使用できるようにする 2 つの方法があります。

  • デザイン時専用の相互運用アセンブリの使用:.NET Framework 4 以降では、相互運用機能アセンブリから実行可能ファイルに型情報を埋め込むようにコンパイラに指示できます。 コンパイラは、アプリケーションで使用する型情報のみを埋め込みます。 アプリケーションで相互運用機能アセンブリを配置する必要はありません。 この手法を使用することをお勧めします。

  • 相互運用機能アセンブリの展開:相互運用機能アセンブリへの標準の参照を作成できます。 この場合、アプリケーションで相互運用機能アセンブリを展開する必要があります。 この手法を採用し、プライベートの COM コンポーネントを使用しない場合は、常に、マネージド コードに組み込む予定の COM コンポーネントの作成者によって発行されたプライマリ相互運用機能アセンブリ (PIA) を参照します。 プライマリ相互運用機能アセンブリの生成と使用の詳細については、「プライマリ相互運用機能」を参照してください。

設計時専用の相互運用機能アセンブリを使用する場合は、COM コンポーネントの作成者によってパブリッシュされたプライマリ相互運用機能アセンブリから型情報を埋め込むことができます。 ただし、アプリケーションを使用してプライマリ相互運用機能アセンブリを展開する必要はありません。

設計時専用の相互運用機能アセンブリを使用すると、ほとんどのアプリケーションは、COM コンポーネントのすべての機能を使用しないため、アプリケーションのサイズが小さくなります。 型情報を埋め込む場合に、コンパイラは非常に効率的です。アプリケーションが、COM インターフェイスでメソッドの一部のみを使用する場合、コンパイラは、使用されないメソッドを埋め込みません。 型情報が埋め込まれているアプリケーションが、そのような別のアプリケーションと対話するか、プライマリ相互運用機能アセンブリを使用するアプリケーションと対話する場合、共通言語ランタイムは、型等価性の規則を使用して、同じ名前の 2 つの型が同じ COM 型を表すかどうかを判断します。 COM オブジェクトを使用するためにこれらの規則を理解する必要はありません。 ただし、規則に興味がある場合は、「Type Equivalence and Embedded Interop Types」(型の等価性と埋め込まれた相互運用機能型) を参照してください。

メタデータ ファイルの生成

COM タイプ ライブラリには、Loanlib.tlb などの .tlb 拡張子を持つスタンドアロンのファイルを指定できます。 一部のタイプ ライブラリは、.dll または .exe ファイルのリソース セクションに埋め込まれます。 タイプ ライブラリ情報の他のソースは、.olb ファイルおよび .ocx ファイルです。

対象とする COM 型の実装を格納するタイプ ライブラリを特定した後は、型のメタデータを含む相互運用機能アセンブリを生成するための次のオプションがあります。

  • Visual Studio

    Visual Studio は、タイプ ライブラリ内の COM 型をアセンブリ内のメタデータに自動的に変換します。 手順については、「方法:タイプ ライブラリへの参照を追加する」にあります。

  • タイプ ライブラリ インポーター (Tlbimp.exe)

    タイプ ライブラリ インポーターは、結果の相互運用機能のファイルのメタデータを調整するコマンド ライン オプションを提供し、既存のタイプ ライブラリから型をインポートし、相互運用機能アセンブリと名前空間を生成します。 手順については、「方法:相互運用機能アセンブリをタイプ ライブラリから生成する」をご覧ください。

  • System.Runtime.InteropServices.TypeLibConverter クラス

    このクラスは、コクラスとタイプ ライブラリ内のインターフェイスをアセンブリ内のメタデータに変換するメソッドを提供します。 これは Tlbimp.exe と同じメタデータ出力を生成します。 ただし、Tlbimp.exe とは異なり、TypeLibConverter クラスは、メモリ内のタイプ ライブラリをメタデータに変換できます。

  • カスタム ラッパー

    タイプ ライブラリが使用できないか正しくない場合、1 つのオプションは、マネージド ソース コードでクラスまたはインターフェイスの重複する定義を作成することです。 その後で、アセンブリ内のメタデータを生成するためにランタイムを対象とするコンパイラでソース コードをコンパイルします。

    COM 型を手動で定義するには、次の項目へのアクセスが必要です。

    • 定義されているコクラスとインターフェイスの正確な説明。

    • C# コンパイラなど、適切な .NET Framework のクラス定義を生成できるコンパイラ。

    • タイプ ライブラリからアセンブリへの変換規則の知識。

    カスタム ラッパーの作成は、高度な手法です。 カスタム ラッパーを生成する方法の詳細については、「標準ラッパーのカスタマイズ」を参照してください。

COM 相互運用機能のインポート処理の詳細については、「Type Library to Assembly Conversion Summary」(タイプ ライブラリからアセンブリへの変換の要約) を参照してください。

関連項目