ClassInterfaceType 列挙体とは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ClassInterfaceType 列挙体

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As ClassInterfaceType

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

C++

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

/** @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 から使用できます。

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;
    }
};