ComClassAttribute, classe

L'attribut ComClassAttribute donne instruction au compilateur d'ajouter des métadonnées qui autorisent une classe à être exposée comme un objet COM.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
<AttributeUsageAttribute(AttributeTargets.Class, Inherited:=False, AllowMultiple:=False)> _
Public NotInheritable Class ComClassAttribute
    Inherits Attribute
'Utilisation
Dim instance As ComClassAttribute

[AttributeUsageAttribute(AttributeTargets.Class, Inherited=false, AllowMultiple=false)] 
public sealed class ComClassAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Class, Inherited=false, AllowMultiple=false)] 
public ref class ComClassAttribute sealed : public Attribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Class, Inherited=false, AllowMultiple=false) */ 
public final class ComClassAttribute extends Attribute

AttributeUsageAttribute(AttributeTargets.Class, Inherited=false, AllowMultiple=false) 
public final class ComClassAttribute extends Attribute

Notes

Pour plus d'informations, consultez la rubrique Visual Basic « ComClassAttribute, classe ».

Utilisez ComClassAttribute pour simplifier le processus d'exposition des composants COM à partir de Visual Basic. Les objets COM sont très différents des assemblys .NET Framework ; sans ComClassAttribute, vous devez suivre un certain nombre d'étapes pour générer un objet COM à partir de Visual Basic. Pour les classes marquées avec ComClassAttribute, le compilateur exécute la plupart de ces étapes automatiquement.

Notes

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 Inscrire pour COM Interop sélectionnée dans la section Générer de la boîte de dialogue Propriétés de Configuration.

Notes

Bien que vous puissiez également exposer une classe créée avec Visual Basic comme objet COM pour le code non managé à utiliser, ce n'est pas un véritable objet COM. Pour plus d'informations, consultez Interopérabilité COM dans les applications .NET Framework.

Exemple

Pour exécuter cet exemple, créez une nouvelle 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

Hiérarchie d'héritage

System.Object
   System.Attribute
    Microsoft.VisualBasic.ComClassAttribute

Sécurité des threads

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0

Voir aussi

Référence

Membres ComClassAttribute
Microsoft.VisualBasic, espace de noms
System.Runtime.InteropServices

Autres ressources

ComClassAttribute, classe
Attributs en Visual Basic
Application d'attributs d'interopérabilité
Membres d'une classe ComClassAttribute
Procédure pas à pas : création d'objets COM avec Visual Basic 2005
VBFixedArrayAttribute, classe
VBFixedStringAttribute, classe
Attributs utilisés dans Visual Basic