ManagedToNativeComInteropStubAttribute クラス

定義

名前空間:

System.Runtime.InteropServices

アセンブリ:

System.Runtime.InteropServices.dll

ソース:

ManagedToNativeComInteropStubAttribute.cs

マネージ型から 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, AllowMultiple=false, Inherited=false)>]
type ManagedToNativeComInteropStubAttribute = class
    inherit Attribute

Public NotInheritable Class ManagedToNativeComInteropStubAttribute
Inherits Attribute

継承

Object

Attribute

ManagedToNativeComInteropStubAttribute

属性

AttributeUsageAttribute

注釈

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

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

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

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

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

インターフェイスの メソッドに 属性を適用して、マネージドからネイティブの 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)