ClassInterfaceAttribute Classe

Définition

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

Héritage

Object

Attribute

ClassInterfaceAttribute

Attributs

AttributeUsageAttribute ComVisibleAttribute

Exemples

L’exemple suivant montre comment appliquer avec la ClassInterfaceAttributeClassInterfaceType valeur AutoDispatch, qui génère une IDispatch interface pour 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

Remarques

Vous pouvez appliquer cet attribut à des assemblys ou des classes.

Cet attribut contrôle si l’exportateur de bibliothèque de types (Tlbexp.exe) génère automatiquement une interface de classe pour la classe attribuée. Une interface de classe porte le même nom que la classe elle-même, mais le nom est précédé d’un trait de soulignement. Lorsqu’elle est exposée, l’interface de classe contient tous les publicmembres , non- static de la classe managée, y compris les membres hérités de sa classe de base. Les classes managées ne peuvent pas accéder à une interface de classe et n’en ont pas besoin, car elles peuvent accéder directement aux membres de la classe. Tlbexp.exe génère un identificateur d’interface unique (IID) pour l’interface de classe.

Les interfaces de classe peuvent être des interfaces doubles ou de répartition uniquement. Si vous le souhaitez, vous pouvez supprimer la génération de l’interface de classe et fournir une interface personnalisée à la place. Vous exposez ou supprimez une interface de classe en spécifiant un System.Runtime.InteropServices.ClassInterfaceType membre d’énumération. Lorsque vous appliquez ClassInterfaceAttribute à un assembly, l’attribut se rapporte à toutes les classes de l’assembly, sauf si les classes individuelles remplacent le paramètre par leur propre attribut.

Bien que les interfaces de classe éliminent la tâche de définir explicitement des interfaces pour chaque classe, leur utilisation dans les applications de production est fortement déconseillée. Les interfaces à deux classes permettent aux clients de se lier à une disposition d’interface spécifique susceptible d’être modifiée à mesure que la classe évolue. Par exemple, considérez une classe managée qui expose une interface de classe aux clients COM. La première version de la classe contient des méthodes North et South. Un client non managé peut être lié à l’interface de classe, qui fournit North comme première méthode dans l’interface de classe et méthode South comme deuxième méthode. Considérez maintenant la prochaine version de la classe , qui a une nouvelle méthode, East, insérée entre les méthodes North et South. Les clients non managés qui tentent de se lier à la nouvelle classe via l’ancienne interface de classe finissent par appeler la méthode East lorsqu’ils ont l’intention d’appeler la méthode South, car le positionnement des méthodes au sein de l’interface a changé. En outre, toute modification apportée à la disposition d’une classe de base affecte également la disposition de l’interface de classe pour toutes les classes dérivées. Les clients managés, qui se lient directement à des classes, ne présentent pas les mêmes problèmes de contrôle de version. Pour obtenir des instructions spécifiques sur l’utilisation d’une interface de classe, consultez WRAPPER COM Callable.

Le Tlbimp.exe (importateur de bibliothèque de types) s’applique toujours aux classes importées membres de l’énumération ClassInterfaceType.None pour indiquer que les classes COM existantes n’exposent jamais d’interfaces managées.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• ClassInterfaceType
• Tlbexp.exe (exportateur de bibliothèques de types)
• Tlbimp.exe (Type Library Importer)