Clase ManagedToNativeComInteropStubAttribute

 

Publicado: octubre de 2016

Proporciona compatibilidad para la personalización de usuario del código auxiliar de interoperabilidad en escenarios de interoperabilidad para COM administrados.

Espacio de nombres:   System.Runtime.InteropServices
Ensamblado:  mscorlib (en mscorlib.dll)

Jerarquía de herencia

System.Object
  System.Attribute
    System.Runtime.InteropServices.ManagedToNativeComInteropStubAttribute

Sintaxis

[AttributeUsageAttribute(AttributeTargets.Method, Inherited = false, 
    AllowMultiple = false)]
[ComVisibleAttribute(false)]
public sealed class ManagedToNativeComInteropStubAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Method, Inherited = false, 
    AllowMultiple = false)]
[ComVisibleAttribute(false)]
public ref class ManagedToNativeComInteropStubAttribute sealed : Attribute

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Method, Inherited = false,
    AllowMultiple = false)>]
[<ComVisibleAttribute(false)>]
type ManagedToNativeComInteropStubAttribute = 
    class
        inherit Attribute
    end

<AttributeUsageAttribute(AttributeTargets.Method, Inherited := False,
    AllowMultiple := False)>
<ComVisibleAttribute(False)>
Public NotInheritable Class ManagedToNativeComInteropStubAttribute
    Inherits Attribute

Constructores

	Nombre	Descripción
	ManagedToNativeComInteropStubAttribute(Type, String)	Inicializa una nueva instancia de la ManagedToNativeComInteropStubAttribute clase con el nombre de tipo y método de la clase especificada.

Propiedades

	Nombre	Descripción
	ClassType	Obtiene la clase que contiene el método de código auxiliar necesario.
	MethodName	Obtiene el nombre del método de código auxiliar.
	TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

Métodos

	Nombre	Descripción
	Equals(Object)	Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve un valor que indica si esta instancia es igual que un objeto especificado.(Heredado de Attribute).
	GetHashCode()	Devuelve el código hash de esta instancia.(Heredado de Attribute).
	GetType()	Obtiene el Type de la instancia actual.(Heredado de Object).
	IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.(Heredado de Attribute).
	Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.(Heredado de Attribute).
	ToString()	Devuelve una cadena que representa el objeto actual.(Heredado de Object).

Implementaciones de interfaz explícitas

	Nombre	Descripción
	_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).
	_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.(Heredado de Attribute).
	_Attribute.GetTypeInfoCount(UInt32)	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).(Heredado de Attribute).
	_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

Comentarios

Este atributo permite a los desarrolladores de interoperabilidad que tienen conocimientos sobre el cálculo de referencias y los mecanismos internos de las llamadas de interoperabilidad hacer lo siguiente:

• Aprovechar las ventajas del código auxiliar de interoperabilidad personalizado en tiempo de compilación en lugar de tiempo de ejecución.

• Depurar el código auxiliar de interoperabilidad personalizado.

• Proporcione capacidades de cálculo de referencias dentro de un código auxiliar que no proporciona el tiempo de ejecución.

• Proporcionan capacidades de envío de método específica del usuario.

Aplique el atributo en un método en una interfaz para especificar un método de código auxiliar correspondiente para la interoperabilidad COM administrada a nativa.

Si este atributo se encuentra en tiempo de ejecución, common language runtime no genera dinámicamente un código auxiliar de interoperabilidad. En su lugar, invoca el código auxiliar personalizado que se creó en tiempo de compilación.

El ManagedToNativeComInteropStubAttribute atributo tiene las siguientes características:

• El atributo se puede usar únicamente en los métodos de interfaces marcadas [ComImport]. Si el atributo se aplica a tipos de interfaz no, se omite en tiempo de ejecución.

• El atributo se puede utilizar sólo una vez en el mismo método en una interfaz. Si se utiliza más de una vez, el compilador genera un error de atributo duplicado.

• El atributo no es puede heredar de una interfaz base. Las interfaces derivadas deben asignar explícitamente el atributo.

• El ensamblado que contiene el método con atributos también debe contener el código auxiliar personalizado.

Métodos de código auxiliar sobrecargados son válidos. Aunque se especifique solo el tipo y el nombre del método de código auxiliar, el runtime detectará el código auxiliar correspondiente. Esto hace examinando todos los argumentos en el método de interfaz y, a continuación, realizar la firma completa coincidente, utilice explícita this puntero.

También es posible que varios métodos en una interfaz para compartir el mismo método de código auxiliar; No obstante, debe tener cuidado al utilizar códigos auxiliares compartidos.

Nota

Métodos de código auxiliar deben ser estáticos.

Podría indicar al runtime que use un código auxiliar de interoperabilidad personalizado en tiempo de compilación en lugar de tiempo de ejecución con el siguiente código de C#:

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

A continuación, puede usar el siguiente código para declarar el método de código auxiliar correspondiente:

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

Información de versión

.NET Framework
Disponible desde 4.0

Seguridad para subprocesos

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Ver también

Espacio de nombres System.Runtime.InteropServices

Volver al principio