Share via


プライマリ相互運用機能アセンブリの作成

プライマリ相互運用機能アセンブリはタイプ ライブラリと同じ発行元によって提供され、そのタイプ ライブラリで定義されている型の公式な定義を提供します。 プライマリ相互運用機能アセンブリの生成および配布は、COM コンポーネントを .NET Framework に公開するための重要な手順です。

プライマリ相互運用機能アセンブリは次の要件を満たしている必要があります。

  • 元のタイプ ライブラリで定義されているすべての COM 型を含み、同じ GUID を保持している。

  • 標準的な公開キー暗号を使った厳密な名前で署名されている。

  • PrimaryInteropAssemblyAttribute 属性が設定されている。

  • 外部 COM 型を再定義しない。

  • 外部の COM に依存する場合にだけ、他のプライマリ相互運用機能アセンブリを参照する。

単一の型定義を使用することによって、すべての .NET Framework アプリケーションがコンパイル時に同じ型にバインドされ、実行時と同様に型のマーシャリングが行われます。 各 COM タイプ ライブラリについて、プライマリ相互運用機能アセンブリを 1 つだけ作成することが重要です。複数のアセンブリを作成すると、型の互換性が失われる可能性があるためです。

相互運用性を向上させるために、個々の型の名前やマーシャリング動作をカスタマイズできます。 出荷後にプライマリ相互運用機能アセンブリを改訂する場合は、新しいバージョンを区別するためにアセンブリのバージョン番号をインクリメントします。

参照

概念

プライマリ相互運用機能アセンブリの命名

プライマリ相互運用機能アセンブリの生成

プライマリ相互運用機能アセンブリのカスタマイズ

開発者へのプライマリ相互運用機能アセンブリの配布

その他の技術情報

プライマリ相互運用機能アセンブリ