IDispatchImplAttribute クラス

定義

警告

この API は現在使われていません。

COM にデュアル インターフェイスと Dispinterface を公開する場合に、共通言語ランタイムが使用する IDispatch 実装を指定します。Indicates which IDispatch implementation the common language runtime uses when exposing dual interfaces and dispinterfaces to COM.

public ref class IDispatchImplAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class, Inherited=false)]
[System.Obsolete("This attribute is deprecated and will be removed in a future version.", false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class IDispatchImplAttribute : Attribute
type IDispatchImplAttribute = class
    inherit Attribute
Public NotInheritable Class IDispatchImplAttribute
Inherits Attribute
継承
IDispatchImplAttribute
属性

次の例は、を適用IDispatchImplAttributeして、 IDispatch共通言語ランタイムによって提供される実装を選択する方法を示しています。The following example demonstrates how to apply IDispatchImplAttribute to select the IDispatch implementation supplied by the common language runtime.

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

// by default all classes in this assembly will use COM implementaion
//   // But this class will use runtime implementaion

[assembly:IDispatchImpl(IDispatchImplType::CompatibleImpl)];
[IDispatchImpl(IDispatchImplType::InternalImpl)]
ref class MyClass{};
using System;
using System.Runtime.InteropServices;
// by default all classes in this assembly will use COM implementaion 
[assembly:IDispatchImpl(IDispatchImplType.CompatibleImpl)]

namespace MyNamespace
{
    // But this class will use runtime implementaion
    [IDispatchImpl(IDispatchImplType.InternalImpl)]
    class MyClass
    {
        //
    }
}

Imports System.Runtime.InteropServices
' by default all classes in this assembly will use COM implementaion 
<Assembly: IDispatchImpl(IDispatchImplType.CompatibleImpl)> 

Module MyNamespace
    ' But this class will use runtime implementaion
    <IDispatchImpl(IDispatchImplType.InternalImpl)> _
    Public Class c
        '
    End Class

End Module

注釈

この属性は、クラスまたはアセンブリに適用できます。You can apply this attribute to classes or assemblies.

この属性は、明示的な実装が必要な場合にのみ設定する必要があります。This attribute should only be set when an explicit implementation is required. 属性をにCompatibleImpl設定するとIDispatch 、オブジェクトの型情報を COM のCreateStdDispatch API に渡すことによって実装が提供されます。When you set the attribute to CompatibleImpl, the IDispatch implementation is supplied by passing the type information for the object to COM's CreateStdDispatch API. 属性をにInternalImpl IDispatch設定すると、共通言語ランタイムによって実装が提供されます。When you set the attribute to InternalImpl, the IDispatch implementation is supplied by the common language runtime. 属性をにSystemDefinedImpl設定すると、ランタイムは適切な実装を選択できます。Setting the attribute to SystemDefinedImpl allows the runtime to choose the appropriate implementation. アセンブリで属性を使用する場合、属性は、アセンブリ内で定義されているすべてのクラスに適用されます。When using the attribute on an assembly, the attribute applies to all classes defined within the assembly. 個々のクラスで属性を使用する場合、属性は、そのクラスによって公開されているインターフェイスにのみ適用され、任意のアセンブリレベルの設定をオーバーライドします。When using the attribute on an individual class, the attribute applies only to the interfaces exposed by that class and overrides any assembly-level setting.

コンストラクター

IDispatchImplAttribute(IDispatchImplType)

IDispatchImplAttribute クラスの新しいインスタンスを、指定した IDispatchImplType 値を使用して初期化します。Initializes a new instance of the IDispatchImplAttribute class with specified IDispatchImplType value.

IDispatchImplAttribute(Int16)

IDispatchImplAttribute クラスの新しいインスタンスを、指定した IDispatchImplType 値を使用して初期化します。Initializes a new instance of the IDispatchImplAttribute class with specified IDispatchImplType value.

プロパティ

TypeId

派生クラスで実装されると、この Attribute の一意の識別子を取得します。When implemented in a derived class, gets a unique identifier for this Attribute.

(継承元 Attribute)
Value

クラスが使用する IDispatchImplType 値を取得します。Gets the IDispatchImplType value used by the class.

メソッド

Equals(Object)

このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。Returns a value that indicates whether this instance is equal to a specified object.

(継承元 Attribute)
GetHashCode()

このインスタンスのハッシュ コードを返します。Returns the hash code for this instance.

(継承元 Attribute)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
IsDefaultAttribute()

派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(継承元 Attribute)
Match(Object)

派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(継承元 Attribute)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
ToString()

現在のオブジェクトを表す string を返します。Returns a string that represents the current object.

(継承元 Object)

明示的なインターフェイスの実装

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

一連の名前を対応する一連のディスパッチ識別子に割り当てます。Maps a set of names to a corresponding set of dispatch identifiers.

(継承元 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。Retrieves the type information for an object, which can be used to get the type information for an interface.

(継承元 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(継承元 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。Provides access to properties and methods exposed by an object.

(継承元 Attribute)

適用対象

こちらもご覧ください