ManagedToNativeComInteropStubAttribute クラス

定義

マネージ型から COM への相互運用シナリオにおけるユーザーによる相互運用スタブのカスタマイズのサポートを提供します。

public ref class ManagedToNativeComInteropStubAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)]
public sealed class ManagedToNativeComInteropStubAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)]
public sealed class ManagedToNativeComInteropStubAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(false)]
public sealed class ManagedToNativeComInteropStubAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)>]
type ManagedToNativeComInteropStubAttribute = class
    inherit Attribute
[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
type ManagedToNativeComInteropStubAttribute = class
    inherit Attribute
[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type ManagedToNativeComInteropStubAttribute = class
    inherit Attribute
Public NotInheritable Class ManagedToNativeComInteropStubAttribute
Inherits Attribute
継承
ManagedToNativeComInteropStubAttribute
属性

注釈

この属性を使用すると、マーシャリングと相互運用呼び出しの内部動作に関する知識を持つ相互運用開発者は、次のことを行うことができます。

  • 実行時ではなく、ビルド時にカスタマイズされた相互運用スタブを利用します。

  • カスタマイズされた相互運用スタブをデバッグします。

  • ランタイムが提供していないスタブ内にマーシャリング機能を提供します。

  • ユーザー固有のメソッド ディスパッチ機能を提供します。

インターフェイス内のメソッドに属性を適用して、マネージドからネイティブへの COM 相互運用に対応するスタブ メソッドを指定します。

実行時にこの属性が検出された場合、共通言語ランタイムは相互運用スタブを動的に生成しません。 代わりに、ビルド時に作成されたカスタム スタブを呼び出します。

この ManagedToNativeComInteropStubAttribute 属性には、次の特性があります。

  • この属性は、マーク [ComImport]されているインターフェイスのメソッドでのみ使用できます。 属性がインターフェイス以外の型に適用されている場合、ランタイムによって無視されます。

  • この属性は、インターフェイス内の同じメソッドで 1 回だけ使用できます。 複数回使用すると、コンパイラによって重複する属性エラーが生成されます。

  • この属性は、基本インターフェイスから継承できません。 派生インターフェイスでは、属性を明示的に割り当てる必要があります。

  • 属性付きメソッドを含むアセンブリには、カスタマイズされたスタブも含まれている必要があります。

オーバーロードされたスタブ メソッドは有効です。 スタブ メソッドの型と名前のみを指定しますが、ランタイムは対応するスタブを検出します。 これを行うには、インターフェイス メソッドのすべての引数を調べ、明示的な this ポインターを使用して完全なシグネチャの一致を実行します。

インターフェイス内の複数のメソッドで同じスタブ メソッドを共有することもできます。ただし、共有スタブを使用する場合は注意する必要があります。

注意

スタブ メソッドは静的である必要があります。

次の C# コードを使用して、実行時ではなく、ビルド時にカスタマイズされた相互運用スタブを使用するようにランタイムに通知できます。

[ComImport]  
interface IMyInterface  
{  
    [ManagedToNativeComInteropStubAttribute(typeof(TestStubClass),  
              "ForwardTestStub")]  
    void GetString (string arg);  
}  

その後、次のコードを使用して、対応するスタブ メソッドを宣言できます。

class TestStubClass  
{  
    internal static void ForwardTestStub(IMyInterface thisObject,  
             string arg) {…}  
}  

コンストラクター

ManagedToNativeComInteropStubAttribute(Type, String)

指定されたクラス型とメソッド名を使用して、ManagedToNativeComInteropStubAttribute クラスの新しいインスタンスを初期化します。

プロパティ

ClassType

必要なスタブ メソッドを格納するクラスを取得します。

MethodName

スタブ メソッドの名前を取得します。

TypeId

派生クラスで実装されると、この Attribute の一意の識別子を取得します。

(継承元 Attribute)

メソッド

Equals(Object)

このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。

(継承元 Attribute)
GetHashCode()

このインスタンスのハッシュ コードを返します。

(継承元 Attribute)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
IsDefaultAttribute()

派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。

(継承元 Attribute)
Match(Object)

派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。

(継承元 Attribute)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

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

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

一連の名前を対応する一連のディスパッチ識別子に割り当てます。

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

オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。

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

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。

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

オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。

(継承元 Attribute)

適用対象