ClassInterfaceAttribute Clase

Definición

public ref class ClassInterfaceAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class, Inherited=false)]
public sealed class ClassInterfaceAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ClassInterfaceAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class, Inherited=false)>]
type ClassInterfaceAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ClassInterfaceAttribute = class
    inherit Attribute

Public NotInheritable Class ClassInterfaceAttribute
Inherits Attribute

Herencia

Object

Attribute

ClassInterfaceAttribute

Atributos

AttributeUsageAttribute ComVisibleAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo aplicar con ClassInterfaceAttribute el ClassInterfaceType valor AutoDispatch, que genera una IDispatch interfaz para MyClass.

using namespace System::Runtime::InteropServices;

[ClassInterface(ClassInterfaceType::AutoDispatch)]
public ref class MyClass
{
public:
   MyClass(){}

};

using System.Runtime.InteropServices;

[ClassInterface(ClassInterfaceType.AutoDispatch)]
public class MyClass
{
   public MyClass() {}
}

Imports System.Runtime.InteropServices

<ClassInterface(ClassInterfaceType.AutoDispatch)> _
Public Class SampleClass    
    ' Insert class members here.
End Class

Comentarios

Puede aplicar este atributo a ensamblados o clases.

Este atributo controla si el exportador de la biblioteca de tipos (Tlbexp.exe) genera automáticamente una interfaz de clase para la clase con atributos. Una interfaz de clase lleva el mismo nombre que la propia clase, pero el nombre tiene como prefijo un carácter de subrayado. Cuando se expone, la interfaz de clase contiene todos los publicmiembros , que no static son miembros de la clase administrada, incluidos los miembros heredados de su clase base. Las clases administradas no pueden acceder a una interfaz de clase y no tienen necesidad de tener acceso a los miembros de la clase directamente. Tlbexp.exe genera un identificador de interfaz único (IID) para la interfaz de clase.

Las interfaces de clase pueden ser interfaces de solo envío o duales. Opcionalmente, puede suprimir la generación de la interfaz de clase y proporcionar una interfaz personalizada en su lugar. Exponga o suprima una interfaz de clase especificando un System.Runtime.InteropServices.ClassInterfaceType miembro de enumeración. Cuando se aplica ClassInterfaceAttribute a un ensamblado, el atributo pertenece a todas las clases del ensamblado a menos que las clases individuales invaliden la configuración con su propio atributo.

Aunque las interfaces de clase eliminan la tarea de definir explícitamente interfaces para cada clase, su uso en aplicaciones de producción no se recomienda encarecidamente. Las interfaces de clase dual permiten a los clientes enlazar a un diseño de interfaz específico que está sujeto a cambios a medida que evoluciona la clase. Por ejemplo, considere una clase administrada que expone una interfaz de clase a clientes COM. La primera versión de la clase contiene métodos North y South. Un cliente no administrado puede enlazarse a la interfaz de clase , que proporciona North como el primer método de la interfaz de clase y el método South como segundo método. Ahora considere la siguiente versión de la clase , que tiene un nuevo método, East, insertado entre los métodos North y South. Los clientes no administrados que intentan enlazar a la nueva clase a través de la interfaz de clase antigua terminan llamando al método cuando pretenden llamar al método EastSouth, porque el posicionamiento de los métodos dentro de la interfaz ha cambiado. Además, cualquier cambio en el diseño de una clase base también afecta al diseño de la interfaz de clase para todas las clases derivadas. Los clientes administrados, que se enlazan directamente a clases, no presentan los mismos problemas de control de versiones. Para obtener instrucciones específicas sobre el uso de una interfaz de clase, consulte Contenedor al que se puede llamar COM.

El Tlbimp.exe (Importador de biblioteca de tipos) siempre se aplica a las clases importadas que el ClassInterfaceType.None miembro de enumeración indica que las clases COM existentes nunca exponen interfaces administradas.

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• ClassInterfaceType
• Tlbexp.exe (Exportador de la biblioteca de tipos)
• TlbImp.exe (Importador de la biblioteca de tipos)