ClassInterfaceAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

ClassInterfaceAttribute

Attributi

AttributeUsageAttribute ComVisibleAttribute

Esempio

Nell'esempio seguente viene illustrato come applicare con ClassInterfaceAttribute il ClassInterfaceType valore AutoDispatch, che genera un'interfaccia IDispatch per 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

Commenti

È possibile applicare questo attributo agli assembly o alle classi.

Questo attributo controlla se l'utilità di esportazione della libreria dei tipi (Tlbexp.exe) genera automaticamente un'interfaccia di classe per la classe con attributi. Un'interfaccia di classe contiene lo stesso nome della classe stessa, ma il nome è preceduto da un carattere di sottolineatura. In caso di esposizione, l'interfaccia della classe contiene tutti i publicmembri , non static membri della classe gestita, inclusi i membri ereditati dalla relativa classe di base. Le classi gestite non possono accedere a un'interfaccia di classe e non devono accedere direttamente ai membri della classe. Tlbexp.exe genera un identificatore di interfaccia univoco (IID) per l'interfaccia della classe.

Le interfacce di classe possono essere interfacce duali o solo dispatch. Facoltativamente, è possibile eliminare la generazione dell'interfaccia della classe e fornire invece un'interfaccia personalizzata. È possibile esporre o eliminare un'interfaccia di classe specificando un System.Runtime.InteropServices.ClassInterfaceType membro di enumerazione. Quando si applica ClassInterfaceAttribute a un assembly, l'attributo si riferisce a tutte le classi nell'assembly, a meno che le singole classi non eseguano l'override dell'impostazione con il proprio attributo.

Sebbene le interfacce di classe eliminino l'attività di definire in modo esplicito le interfacce per ogni classe, l'uso nelle applicazioni di produzione è fortemente sconsigliato. Le interfacce di classe doppia consentono ai client di eseguire il binding a un layout di interfaccia specifico soggetto a modifiche man mano che la classe evolve. Si consideri, ad esempio, una classe gestita che espone un'interfaccia di classe ai client COM. La prima versione della classe contiene metodi North e South. Un client non gestito può essere associato all'interfaccia della classe , che fornisce North come primo metodo nell'interfaccia della classe e nel metodo South come secondo metodo. Si consideri ora la versione successiva della classe , che ha un nuovo metodo, East, inserito tra i metodi North e South. I client non gestiti che tentano di eseguire l'associazione alla nuova classe tramite l'interfaccia della classe precedente finiscono per chiamare il metodo East quando intendono chiamare il metodo South, perché il posizionamento dei metodi all'interno dell'interfaccia è cambiato. Inoltre, qualsiasi modifica al layout di una classe base influisce anche sul layout dell'interfaccia di classe per tutte le classi derivate. I client gestiti, che si associano direttamente alle classi, non presentano gli stessi problemi di controllo delle versioni. Per linee guida specifiche sull'uso di un'interfaccia di classe, vedere COM Callable Wrapper.

Il Tlbimp.exe (utilità di importazione della libreria dei tipi) si applica sempre alle classi importate dal ClassInterfaceType.None membro di enumerazione per indicare che le classi COM esistenti non espongono mai interfacce gestite.

Vedi anche

• ClassInterfaceType
• Tlbexp.exe (utilità di esportazione della libreria dei tipi)
• Tlbimp.exe (importatore di librerie di tipi)