ManagedToNativeComInteropStubAttribute Класс

Определение

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

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

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

Public NotInheritable Class ManagedToNativeComInteropStubAttribute
Inherits Attribute

Наследование

Object

Attribute

ManagedToNativeComInteropStubAttribute

Атрибуты

AttributeUsageAttribute ComVisibleAttribute

Комментарии

Этот атрибут позволяет разработчикам взаимодействия, имеющим знания о маршалинге и внутренних действиях вызовов взаимодействия, выполнять следующие действия:

• Воспользуйтесь настраиваемыми заглушками взаимодействия во время сборки вместо времени выполнения.

• Отладка настраиваемых заглушки взаимодействия.

• Предоставьте возможности маршалинга в заглушку, которую среда выполнения не предоставляет.

• Предоставьте возможности отправки определенных пользователем методов.

Атрибут применяется к методу в интерфейсе, чтобы указать соответствующий метод заглушки для управляемого взаимодействия COM.

Если этот атрибут обнаружен во время выполнения, среда CLR не создает заглушку взаимодействия. Вместо этого он вызывает настраиваемую заглушку, созданную во время сборки.

Атрибут ManagedToNativeComInteropStubAttribute имеет следующие характеристики:

• Атрибут можно использовать только для методов из интерфейсов, помеченных [ComImport]. Если атрибут применяется к типам, отличным от интерфейса, он игнорируется средой выполнения.

• Атрибут можно использовать только один раз в одном методе в интерфейсе. Если он используется несколько раз, компилятор создает ошибку повторяющегося атрибута.

• Атрибут не наследуется от базового интерфейса. Производные интерфейсы должны явно назначать атрибут.

• Сборка, содержащая метод атрибута, также должна содержать настраиваемую заглушку.

Перегруженные методы заглушки допустимы. Хотя вы указываете только тип и имя метода заглушки, среда выполнения обнаружит соответствующую заглушку. Это делается путем изучения всех аргументов в методе интерфейса, а затем выполнения полного сопоставления сигнатуры с помощью явного this указателя.

Также можно использовать несколько методов в интерфейсе для совместного использования одного и того же метода заглушки; Однако при использовании общих заглушок следует быть осторожным.

Вы можете сообщить среде выполнения, чтобы использовать настраиваемую заглушку взаимодействия во время сборки вместо времени выполнения с помощью следующего кода C#:

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

Затем можно использовать следующий код для объявления соответствующего метода заглушки:

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