ManagedToNativeComInteropStubAttribute Klas

Definitie

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

Overname

Object

Attribute

ManagedToNativeComInteropStubAttribute

Kenmerken

AttributeUsageAttribute ComVisibleAttribute

Opmerkingen

Met dit kenmerk kunnen ontwikkelaars die kennis hebben over marshaling en de interne werking van interop-aanroepen het volgende doen:

• Profiteer van aangepaste interop-stubs tijdens de build in plaats van runtime.

• Fouten opsporen in aangepaste interop-stubs.

• Bieden marshaling-mogelijkheden binnen een stub die de runtime niet biedt.

• Bied gebruikersspecifieke verzendmogelijkheden voor methoden.

U past het kenmerk toe op een methode in een interface om een bijbehorende stub-methode op te geven voor com-interoperabiliteit van beheerde naar systeemeigen COM.

Als dit kenmerk tijdens de runtime wordt aangetroffen, genereert de algemene taalruntime geen stub voor interop. In plaats daarvan wordt de aangepaste stub aangeroepen die tijdens de build is gemaakt.

Het ManagedToNativeComInteropStubAttribute kenmerk heeft de volgende kenmerken:

• Het kenmerk kan alleen worden gebruikt voor methoden van interfaces die zijn gemarkeerd [ComImport]. Als het kenmerk wordt toegepast op niet-interfacetypen, wordt het genegeerd door de runtime.

• Het kenmerk kan slechts eenmaal op dezelfde methode in een interface worden gebruikt. Als deze meer dan één keer wordt gebruikt, genereert de compiler een dubbele kenmerkfout.

• Het kenmerk kan niet worden overgenomen van een basisinterface. Afgeleide interfaces moeten het kenmerk expliciet toewijzen.

• De assembly die de toegewezen methode bevat, moet ook de aangepaste stub bevatten.

Overbelaste stubmethoden zijn geldig. Hoewel u alleen het type en de naam van de stub-methode opgeeft, detecteert de runtime de bijbehorende stub. Dit doet u door alle argumenten op de interfacemethode te onderzoeken en vervolgens volledige handtekeningkoppeling uit te voeren met behulp van een expliciete this aanwijzer.

Het is ook mogelijk dat meerdere methoden in een interface dezelfde stubmethode delen; U moet echter voorzichtig zijn wanneer u gedeelde stubs gebruikt.

U kunt de runtime informeren over het gebruik van een aangepaste interop-stub tijdens de build in plaats van runtime met de volgende C#-code:

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

Vervolgens kunt u de volgende code gebruiken om de bijbehorende stub-methode te declareren:

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