ComClassAttribute Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
L’attribut ComClassAttribute indique au compilateur d’ajouter des métadonnées qui permettent à une classe d’être exposée en tant qu’objet COM.
public ref class ComClassAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=false)]
public sealed class ComClassAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=false)>]
type ComClassAttribute = class
inherit Attribute
Public NotInheritable Class ComClassAttribute
Inherits Attribute
- Héritage
- Attributs
Exemples
Pour exécuter cet exemple, créez une application bibliothèque de classes et ajoutez le code suivant à un module de classe.
<ComClass(ComClass1.ClassId, ComClass1.InterfaceId, ComClass1.EventsId)>
Public Class ComClass1
' Use the Region directive to define a section named COM Guids.
#Region "COM GUIDs"
' These GUIDs provide the COM identity for this class
' and its COM interfaces. You can generate
' these guids using guidgen.exe
Public Const ClassId As String = "7666AC25-855F-4534-BC55-27BF09D49D46"
Public Const InterfaceId As String = "54388137-8A76-491e-AA3A-853E23AC1217"
Public Const EventsId As String = "EA329A13-16A0-478d-B41F-47583A761FF2"
#End Region
Public Sub New()
MyBase.New()
End Sub
Function AddNumbers(ByVal X As Integer, ByVal Y As Integer)
AddNumbers = X + Y
End Function
End Class
Remarques
Utilisez ComClassAttribute pour simplifier le processus d’exposition de composants COM à partir de Visual Basic. Les objets COM sont très différents des assemblys .NET Framework ; sans ComClassAttribute, vous devez suivre plusieurs étapes pour générer un objet COM à partir de Visual Basic. Pour les classes marquées avec ComClassAttribute, le compilateur effectue automatiquement la plupart de ces étapes.
Note
Cet attribut simplifie la création d’objets COM. Pour exposer une classe en tant qu’objet COM, vous devez compiler le projet avec l’option Register for COM Interop sélectionnée dans la section Build de la boîte de dialogue Propriétés de configuration .
Note
Bien que vous puissiez également exposer une classe créée avec Visual Basic en tant qu’objet COM pour le code non managé à utiliser, il n’est pas un vrai objet COM. Pour plus d’informations, consultez l’interopérabilité COM dans les applications .NET Framework.
Constructeurs
| Nom | Description |
|---|---|
| ComClassAttribute() |
Initialise une nouvelle instance de la classe |
| ComClassAttribute(String, String, String) |
Initialise une nouvelle instance de la classe |
| ComClassAttribute(String, String) |
Initialise une nouvelle instance de la classe |
| ComClassAttribute(String) |
Initialise une nouvelle instance de la classe |
Propriétés
| Nom | Description |
|---|---|
| ClassID |
Obtient un ID de classe utilisé pour identifier de manière unique une classe. |
| EventID |
Obtient un ID d’événement utilisé pour identifier un événement de manière unique. |
| InterfaceID |
Obtient un ID d’interface utilisé pour identifier de manière unique une interface. |
| InterfaceShadows |
Indique que le nom de l’interface COM ombre un autre membre de la classe ou de la classe de base. |
| TypeId |
En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute) |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute) |
| GetHashCode() |
Retourne le code de hachage pour cette instance. (Hérité de Attribute) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| IsDefaultAttribute() |
En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut de la classe dérivée. (Hérité de Attribute) |
| Match(Object) |
En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Récupère les informations de type d’un objet, qui peuvent être utilisées pour obtenir les informations de type d’une interface. (Hérité de Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fournit l’accès aux propriétés et méthodes exposées par un objet. (Hérité de Attribute) |