PrimaryInteropAssemblyAttribute クラス

.NET Framework クラス ライブラリ リファレンス

PrimaryInteropAssemblyAttribute クラス

この属性が適用されたアセンブリが、プライマリ相互運用機能アセンブリであることを示します。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited:=False, AllowMultiple:=True)>
 _
Public NotInheritable Class
 PrimaryInteropAssemblyAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As PrimaryInteropAssemblyAttribute

C#

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false,
 AllowMultiple=true)] 
public sealed class PrimaryInteropAssemblyAttribute
 : Attribute

C++

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets::Assembly, Inherited=false,
 AllowMultiple=true)] 
public ref class PrimaryInteropAssemblyAttribute
 sealed : public Attribute

J#

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false,
 AllowMultiple=true) */ 
public final class PrimaryInteropAssemblyAttribute
 extends Attribute

JScript

ComVisibleAttribute(true) 
AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false,
 AllowMultiple=true) 
public final class PrimaryInteropAssemblyAttribute
 extends Attribute

解説

この属性は、タイプ ライブラリをインポートするときに タイプ ライブラリ インポータ (Tlbimp.exe) が基本的に自動適用しますが、アセンブリに明示的に適用することもできます。

相互運用機能アセンブリには既存の COM 型を記述するメタデータが含まれていますが、これは多くの場合 COM タイプ ライブラリに既に記述されています。Tlbimp.exe は、COM タイプ ライブラリから相互運用機能アセンブリを生成します。通常、相互運用機能アセンブリには、コードではなくメタデータだけを格納します。プライマリ相互運用機能アセンブリは、それらのアセンブリが記述しているタイプ ライブラリと同じ発行元によって提供され、そのタイプ ライブラリで定義されている型の正式な定義を提供します。プライマリ相互運用機能アセンブリは、必ずそれぞれの発行元によって署名され、その一意性が確保されます。

プライマリ相互運用機能アセンブリは、以下の方法でタイプ ライブラリから生成できます。

• /primary オプションを付けて TlbImp.exe をコマンドラインから実行します。

• デザイン時に PrimaryInteropAssemblyAttribute を適用します。

マネージ ソース コードでプライマリ相互運用機能アセンブリを指定するには、デザイン時に System.Runtime.InteropServices.GuidAttribute と PrimaryInteropAssemblyAttribute をアセンブリに適用する必要があります。プライマリ相互運用機能アセンブリの GuidAttribute は、タイプ ライブラリの LIBID を識別し、PrimaryInteropAssemblyAttribute は、該当するアセンブリがプライマリ相互運用機能アセンブリである特定のタイプ ライブラリのバージョンを識別します。アセンブリが、同じタイプ ライブラリの複数バージョンのプライマリ相互運用機能アセンブリである場合は、PrimaryInteropAssemblyAttribute が何度も使用されることがあります。

タイプ ライブラリで定義されている型を使用する場合は、その型自体を再インポートまたは再定義するのではなく、そのタイプ ライブラリに対応するプライマリ相互運用機能アセンブリを参照します。プライマリ相互運用機能アセンブリの生成方法および使用方法のガイドラインと手順については、「プライマリ相互運用機能アセンブリ」を参照してください。タイプ ライブラリのインポート プロセスの詳細については、「タイプ ライブラリからアセンブリへの変換の要約」を参照してください。

継承階層

System.Object
   System.Attribute
    System.Runtime.InteropServices.PrimaryInteropAssemblyAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PrimaryInteropAssemblyAttribute メンバ
System.Runtime.InteropServices 名前空間
GuidAttribute クラス
その他の技術情報
タイプ ライブラリ インポータ (Tlbimp.exe)
プライマリ相互運用機能アセンブリ