ManagedToNativeComInteropStubAttribute クラス

定義

マネージ型から COM への相互運用シナリオにおけるユーザーによる相互運用スタブのカスタマイズのサポートを提供します。Provides support for user customization of interop stubs in managed-to-COM interop scenarios.

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

注釈

この属性を使用すると、マーシャリングに関する知識を持つ相互運用開発者は、次の操作を実行するための相互運用呼び出しの内部処理を行うことができます。This attribute enables interop developers who have knowledge about marshaling and the inner workings of interop calls to do the following:

  • 実行時ではなく、カスタマイズされた相互運用機能のスタブをビルド時に利用します。Take advantage of customized interop stubs at build time instead of run time.

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

  • ランタイムによって提供されないスタブ内でマーシャリング機能を提供します。Provide marshaling capabilities within a stub that the runtime does not provide.

  • ユーザー固有のメソッドディスパッチ機能を提供します。Provide user-specific method dispatch capabilities.

インターフェイスのメソッドに属性を適用して、マネージとネイティブの COM 相互運用に対応するスタブメソッドを指定します。You apply the attribute on a method in an interface to specify a corresponding stub method for managed-to-native COM interop.

実行時にこの属性が検出された場合、共通言語ランタイムは相互運用スタブを動的に生成しません。If this attribute is encountered during run time, the common language runtime does not dynamically generate an interop stub. 代わりに、ビルド時に作成されたカスタムスタブを呼び出します。Instead, it invokes the custom stub that was created at build time.

ManagedToNativeComInteropStubAttribute属性には次の特性があります。The ManagedToNativeComInteropStubAttribute attribute has the following characteristics:

  • 属性は、とマーク[ComImport]されているインターフェイスのメソッドに対してのみ使用できます。The attribute can be used only on methods from interfaces that are marked [ComImport]. 属性が非インターフェイス型に適用されている場合は、ランタイムによって無視されます。If the attribute is applied to non-interface types, it is ignored by the runtime.

  • 属性は、インターフェイスの同じメソッドで1回だけ使用できます。The attribute can be used only once on the same method in an interface. 複数回使用されている場合は、重複する属性エラーが生成されます。If it is used more than once, the compiler generates a duplicated attribute error.

  • 属性は、基本インターフェイスから継承できません。The attribute is not inheritable from a base interface. 派生インターフェイスでは、属性を明示的に割り当てる必要があります。Derived interfaces must explicitly assign the attribute.

  • 属性付きメソッドを含むアセンブリにも、カスタマイズされたスタブが含まれている必要があります。The assembly that contains the attributed method must also contain the customized stub.

オーバーロードされたスタブメソッドは有効です。Overloaded stub methods are valid. スタブメソッドの型と名前だけを指定しても、対応するスタブはランタイムによって検出されます。Although you specify only the type and the name of the stub method, the runtime will discover the corresponding stub. これを行うには、インターフェイスメソッドのすべての引数を調べ、明示的thisなポインターを使用してシグネチャの完全一致を実行します。It does this by examining all the arguments on the interface method, and then performing full signature matching by using an explicit this pointer.

また、インターフェイス内の複数のメソッドで同じスタブメソッドを共有することもできます。ただし、共有スタブを使用する場合は注意が必要です。It is also possible for multiple methods in an interface to share the same stub method; however, you should be careful when you use shared stubs.

注意

スタブメソッドは静的である必要があります。Stub methods must be static.

次C#のコードを使用して、実行時ではなく、カスタマイズされた相互運用スタブをビルド時に使用するように、ランタイムに通知できます。You could inform the runtime to use a customized interop stub at build time instead of run time with the following C# code:

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

その後、次のコードを使用して、対応するスタブメソッドを宣言できます。You could then use the following code to declare the corresponding stub method:

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

コンストラクター

ManagedToNativeComInteropStubAttribute(Type, String)

指定されたクラス型とメソッド名を使用して、ManagedToNativeComInteropStubAttribute クラスの新しいインスタンスを初期化します。Initializes a new instance of the ManagedToNativeComInteropStubAttribute class with the specified class type and method name.

プロパティ

ClassType

必要なスタブ メソッドを格納するクラスを取得します。Gets the class that contains the required stub method.

MethodName

スタブ メソッドの名前を取得します。Gets the name of the stub method.

TypeId

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

(継承元 Attribute)

メソッド

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)

適用対象