ManagedToNativeComInteropStubAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

ManagedToNativeComInteropStubAttribute

Attributi

AttributeUsageAttribute ComVisibleAttribute

Commenti

Questo attributo consente agli sviluppatori di interoperabilità che hanno conoscenze sul marshalling e sulle operazioni interne delle chiamate di interoperabilità per eseguire le operazioni seguenti:

• Sfruttare i vantaggi degli stub di interoperabilità personalizzati in fase di compilazione anziché in fase di esecuzione.

• Eseguire il debug di stub di interoperabilità personalizzati.

• Fornire funzionalità di marshalling all'interno di uno stub che il runtime non fornisce.

• Fornire funzionalità di invio del metodo specifiche dell'utente.

L'attributo viene applicato a un metodo in un'interfaccia per specificare un metodo stub corrispondente per l'interoperabilità COM gestita-nativa.

Se questo attributo viene rilevato durante l'esecuzione, Common Language Runtime non genera in modo dinamico uno stub di interoperabilità. Richiama invece lo stub personalizzato creato in fase di compilazione.

L'attributo ManagedToNativeComInteropStubAttribute presenta le caratteristiche seguenti:

• L'attributo può essere usato solo sui metodi delle interfacce contrassegnate come [ComImport]. Se l'attributo viene applicato ai tipi non di interfaccia, viene ignorato dal runtime.

• L'attributo può essere usato una sola volta sullo stesso metodo in un'interfaccia. Se viene usato più volte, il compilatore genera un errore di attributo duplicato.

• L'attributo non è ereditabile da un'interfaccia di base. Le interfacce derivate devono assegnare in modo esplicito l'attributo .

• L'assembly che contiene il metodo con attributi deve contenere anche lo stub personalizzato.

I metodi stub di overload sono validi. Anche se si specifica solo il tipo e il nome del metodo stub, il runtime rileverà lo stub corrispondente. A tale scopo, esaminare tutti gli argomenti nel metodo di interfaccia e quindi eseguire la corrispondenza completa della firma usando un puntatore esplicito this .

È anche possibile che più metodi in un'interfaccia convidano lo stesso metodo stub; Tuttavia, è consigliabile prestare attenzione quando si usano stub condivisi.

È possibile informare il runtime di usare uno stub di interoperabilità personalizzato in fase di compilazione anziché in fase di esecuzione con il codice C# seguente:

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

È quindi possibile usare il codice seguente per dichiarare il metodo stub corrispondente:

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