ClassInterfaceType 列挙体

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

ClassInterfaceType 列挙体

クラスに対して生成するクラス インターフェイスの型を識別します。

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

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration ClassInterfaceType

Visual Basic (使用法)

Dim instance As ClassInterfaceType

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum ClassInterfaceType

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum class ClassInterfaceType

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public enum ClassInterfaceType

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public enum ClassInterfaceType

メンバ

	メンバ名	説明
	AutoDispatch	クラスが COM クライアントに対して遅延バインディングだけをサポートすることを示します。クラスのディスパッチ インターフェイスは、要求に応じて自動的に COM クライアントに公開されます。型 タイプ ライブラリ エクスポータ (Tlbexp.exe) によって生成されるタイプ ライブラリには、クライアントがこのディスパッチ インターフェイスの DISPID をキャッシュしないようにするために、そのインターフェイスの型情報は含まれません。クライアントがこのディスパッチ インターフェイスに対して実行できるのは遅延バインディングだけであるため、ClassInterfaceAttribute で説明したようなバージョン管理の問題は、このインターフェイスでは発生しません。  これは、ClassInterfaceAttribute の既定の設定です。
	AutoDual	クラスに対してデュアル クラス インターフェイスを自動的に生成し、COM に公開することを示します。型情報は、クラス インターフェイスに対して作成され、タイプ ライブラリで公開されます。ClassInterfaceAttribute で説明したようなバージョン管理の制約があるため、AutoDual は使用しないことを強くお勧めします。
	None	クラスに対してクラス インターフェイスを生成しないことを示します。インターフェイスを明示的に実装していないクラスには、IDispatch インターフェイスを通じた遅延バインディングによってしかアクセスできません。これは、ClassInterfaceAttribute の推奨値です。このクラスが明示的に実装しているインターフェイスを通じて機能を公開するには、ClassInterfaceType.None の使用が唯一の方法です。  タイプ ライブラリ エクスポータ (Tlbexp.exe) は、クラスが 1 番目に実装しているパブリックで COM 参照可能なインターフェイスを、コクラスの既定のインターフェイスとして公開します。.NET Framework Version 2.0 からは、ComDefaultInterfaceAttribute 属性を使用して、COM に公開される既定のインターフェイスを指定できます。クラスが実装しているインターフェイスがない場合は、基本クラスが 1 番目に実装しているパブリックで COM 参照可能なインターフェイスが既定のインターフェイスとなります。このとき、最後に派生した基本クラスから逆順に検索されます。クラスもその基本クラスもインターフェイスを実装していない場合、Tlbexp.exe は _Object を既定のインターフェイスとして公開します。

解説

この列挙体は、ClassInterfaceAttribute 属性と組み合わせて使用します。

使用例

ClassInterfaceAttribute を型に適用し、ClassInterfaceType を設定する例を次に示します。この方法で定義されたクラスは、アンマネージ COM から使用できます。

C#

using System;
using System.Runtime.InteropServices;

// Have the CLR expose a class interface (derived from IDispatch) for
 this type.
// COM clients can call the  members of this class using the Invoke
 method from the IDispatch interface.
[ClassInterface(ClassInterfaceType.AutoDispatch)]
public class AClassUsableViaCOM
{
    public AClassUsableViaCOM() { }

    public Int32 Add(Int32 x, Int32 y) { return
 x + y; }
}

// The CLR does not expose a class interface for this type.
// COM clients can call the members of this class using the methods
 from the IComparable interface.
[ClassInterface(ClassInterfaceType.None)]
public class AnotherClassUsableViaCOM : IComparable
{
    public AnotherClassUsableViaCOM() { }

    Int32 IComparable.CompareTo(Object o) { return 0; }
}

C++

using namespace System;
using namespace System::Runtime::InteropServices;

// Have the CLR expose a class interface (derived from IDispatch)
// for this type. COM clients can call the  members of this
// class using the Invoke method from the IDispatch interface.
[ClassInterface(ClassInterfaceType::AutoDispatch)]
public ref class AClassUsableViaCOM
{
public:
    AClassUsableViaCOM() 
    { 
    }

public:
    int Add(int x, int y)
    {
        return x + y;
    }
};

// The CLR does not expose a class interface for this type.
// COM clients can call the members of this class using
// the methods from the IComparable interface.
[ClassInterface(ClassInterfaceType::None)]
public ref class AnotherClassUsableViaCOM :
 public IComparable
{
public:
    AnotherClassUsableViaCOM() 
    { 
    }

    virtual int CompareTo(Object^ o) = IComparable::CompareTo
    {
        return 0;
    }
};

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
System.Runtime.InteropServices 名前空間
その他の技術情報
タイプ ライブラリ エクスポータ (Tlbexp.exe)