Clase InterfaceTypeAttribute

 

Publicado: octubre de 2016

Indica si una interfaz administrada es dual, solo de envío, o IUnknown -solo cuando se expone a COM.

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

Jerarquía de herencia

System.Object
  System.Attribute
    System.Runtime.InteropServices.InterfaceTypeAttribute

Sintaxis

[AttributeUsageAttribute(AttributeTargets.Interface, Inherited = false)]
[ComVisibleAttribute(true)]
public sealed class InterfaceTypeAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Interface, Inherited = false)]
[ComVisibleAttribute(true)]
public ref class InterfaceTypeAttribute sealed : Attribute

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Interface, Inherited = false)>]
[<ComVisibleAttribute(true)>]
type InterfaceTypeAttribute = 
    class
        inherit Attribute
    end

<AttributeUsageAttribute(AttributeTargets.Interface, Inherited := False)>
<ComVisibleAttribute(True)>
Public NotInheritable Class InterfaceTypeAttribute
    Inherits Attribute

Constructores

	Nombre	Descripción
	InterfaceTypeAttribute(ComInterfaceType)	Inicializa una nueva instancia de la InterfaceTypeAttribute clase con los valores especificados ComInterfaceType miembro de enumeración.
	InterfaceTypeAttribute(Int16)	Inicializa una nueva instancia de la InterfaceTypeAttribute clase con los valores especificados ComInterfaceType miembro de enumeración.

Propiedades

	Nombre	Descripción
	TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).
	Value	Obtiene el ComInterfaceType valor que describe la forma en que la interfaz debe exponerse a COM.

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 se puede aplicar a las interfaces.

De forma predeterminada, la Tlbexp.exe (Type Library Exporter) expone una interfaz administrada a COM como una interfaz dual, lo que proporciona la flexibilidad de enlace o el rendimiento de enlace temprano. El ComInterfaceType enumeración permite invalidar el comportamiento predeterminado y especificar el tiempo de enlace sólo o enlace sólo. Por ejemplo, puede aplicar InterfaceType (ComInterfaceType.InterfaceIsIDispatch) a una interfaz para crear metadatos que limiten los llamadores al enlace sólo más tarde. Aunque las interfaces que derivan de la IDispatch interfaz suelen ser dual, el InterfaceIsIDispatch miembro de enumeración permite sólo en tiempo de ejecución llama a los métodos de interfaz. Este atributo no tiene ningún efecto en la vista administrada de la interfaz. Para obtener información adicional sobre cómo exponer interfaces a COM, vea la conversión de tipos exportados.

El Tlbimp.exe (Type Library Importer) también aplica este atributo a interfaces de nondual importado, sino que aplicará el miembro de enumeración correspondiente para indicar que la interfaz es sólo de envío o IUnknown -solo.

Ejemplos

El ejemplo siguiente se muestra cómo InterfaceTypeAttribute controla la forma en que la interfaz se expone a COM.

using System.Runtime.InteropServices;

//Interface is exposed to COM as dual.
interface IMyInterface1 
{
    //Insert code here.
}

//Interface is exposed to COM as IDispatch.
[InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIDispatch)]
interface IMyInterface2 
{
    //Insert code here.
}

Imports System.Runtime.InteropServices

'Interface is exposed to COM as dual.
Interface IMyInterface1
     'Insert code here.
End Interface

'Interface is exposed to COM as IDispatch.
<InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIDispatch)> _
Interface IMyInterface2
    'Insert code here.
End Interface

using namespace System::Runtime::InteropServices;

//Interface is exposed to COM as dual.
interface class IMyInterface1{};

//Insert code here.
//Interface is exposed to COM as IDispatch.

[InterfaceTypeAttribute(ComInterfaceType::InterfaceIsIDispatch)]
interface class IMyInterface2{};
//Insert code here.

Información de versión

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

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

ComInterfaceType
Espacio de nombres System.Runtime.InteropServices
Tlbexp.exe (Type Library Exporter)
Tlbimp.exe (Type Library Importer)

Volver al principio