Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase ManagedToNativeComInteropStubAttribute

.NET Framework (current version)
 

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)

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

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

NombreDescripción
System_CAPS_pubmethodManagedToNativeComInteropStubAttribute(Type, String)

Inicializa una nueva instancia de la ManagedToNativeComInteropStubAttribute clase con el nombre de tipo y método de la clase especificada.

NombreDescripción
System_CAPS_pubpropertyClassType

Obtiene la clase que contiene el método de código auxiliar necesario.

System_CAPS_pubpropertyMethodName

Obtiene el nombre del método de código auxiliar.

System_CAPS_pubpropertyTypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

NombreDescripción
System_CAPS_pubmethodEquals(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).

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Heredado de Attribute).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsDefaultAttribute()

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).

System_CAPS_pubmethodMatch(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).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_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).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_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).

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.

System_CAPS_noteNota

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) {…}
}

.NET Framework
Disponible desde 4.0

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.

Volver al principio
Mostrar: