ComClassAttribute Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Das attribut ComClassAttribute weist den Compiler an, Metadaten hinzuzufügen, mit denen eine Klasse als COM-Objekt verfügbar gemacht werden kann.
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
- Vererbung
- Attribute
Beispiele
Erstellen Sie zum Ausführen dieses Beispiels eine neue Klassenbibliotheksanwendung , und fügen Sie einem Klassenmodul den folgenden Code hinzu.
<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
Hinweise
Verwenden Sie ComClassAttribute, um den Prozess der Bereitstellung von COM-Komponenten aus Visual Basic zu vereinfachen. COM-Objekte unterscheiden sich stark von .NET Framework-Assemblys. Ohne die ComClassAttribute müssen Sie eine Reihe von Schritten ausführen, um ein COM-Objekt aus Visual Basic zu generieren. Bei Klassen, die mit ComClassAttributegekennzeichnet sind, führt der Compiler viele dieser Schritte automatisch aus.
Note
Dieses Attribut vereinfacht die Erstellung von COM-Objekten. Um eine Klasse als COM-Objekt verfügbar zu machen, müssen Sie das Projekt kompilieren, wobei die Option "Für COM-Interoperabilität registrieren " im Abschnitt " Build " des Dialogfelds "Konfigurationseigenschaften " ausgewählt ist.
Note
Sie können zwar auch eine Klasse verfügbar machen, die mit Visual Basic als COM-Objekt erstellt wurde, damit nicht verwalteter Code verwendet werden kann, es handelt sich jedoch nicht um ein echtes COM-Objekt. Ausführliche Informationen finden Sie unter COM-Interoperabilität in .NET Framework-Anwendungen.
Konstruktoren
| Name | Beschreibung |
|---|---|
| ComClassAttribute() |
Initialisiert eine neue Instanz der |
| ComClassAttribute(String, String, String) |
Initialisiert eine neue Instanz der |
| ComClassAttribute(String, String) |
Initialisiert eine neue Instanz der |
| ComClassAttribute(String) |
Initialisiert eine neue Instanz der |
Eigenschaften
| Name | Beschreibung |
|---|---|
| ClassID |
Ruft eine Klassen-ID ab, die zum eindeutigen Identifizieren einer Klasse verwendet wird. |
| EventID |
Ruft eine Ereignis-ID ab, die zum eindeutigen Identifizieren eines Ereignisses verwendet wird. |
| InterfaceID |
Ruft eine Schnittstellen-ID ab, die zum eindeutigen Identifizieren einer Schnittstelle verwendet wird. |
| InterfaceShadows |
Gibt an, dass der COM-Schnittstellenname ein anderes Element der Klasse oder Basisklasse schattiert. |
| TypeId |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute) |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute) |
| GetHashCode() |
Gibt den Hashcode für diesen instance zurück. (Geerbt von Attribute) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsDefaultAttribute() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute) |
| Match(Object) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute) |