ManagedToNativeComInteropStubAttribute クラス

定義

public ref class ManagedToNativeComInteropStubAttribute sealed : 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, Inherited=false)]
public sealed class ManagedToNativeComInteropStubAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type ManagedToNativeComInteropStubAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, Inherited=false)>]
type ManagedToNativeComInteropStubAttribute = class
    inherit Attribute

Public NotInheritable Class ManagedToNativeComInteropStubAttribute
Inherits Attribute

継承

Object

Attribute

ManagedToNativeComInteropStubAttribute

属性

AttributeUsageAttribute ComVisibleAttribute

注釈

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

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

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

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

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

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