ComClassAttribute Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Atrybut ComClassAttribute nakazuje kompilatorowi dodanie metadanych, które umożliwiają uwidocznienie klasy jako obiektu 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
- Dziedziczenie
- Atrybuty
Przykłady
Aby uruchomić ten przykład, utwórz nową aplikację biblioteki klas i dodaj następujący kod do modułu klasy.
<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
Uwagi
Użyj ComClassAttribute, aby uprościć proces uwidaczniania składników COM z Visual Basic. Obiekty COM różnią się zupełnie od zestawów platformy .NET; bez ComClassAttribute należy wykonać kilka kroków, aby wygenerować obiekt COM z Visual Basic. W przypadku klas oznaczonych za pomocą ComClassAttributepolecenia kompilator wykonuje wiele z tych kroków automatycznie.
Note
Ten atrybut upraszcza tworzenie obiektów COM. Aby uwidocznić klasę jako obiekt COM, należy skompilować projekt z opcją Zarejestruj dla międzyoperacji modelu COM wybraną w sekcji Kompilacja okna dialogowego Właściwości konfiguracji .
Note
Mimo że można również uwidocznić klasę utworzoną przy użyciu Visual Basic jako obiekt COM dla niezarządzanego kodu, nie jest to prawdziwy obiekt COM. Aby uzyskać szczegółowe informacje, zobacz Współdziałanie COM w aplikacjach .NET Framework.
Konstruktory
| Nazwa | Opis |
|---|---|
| ComClassAttribute() |
Inicjuje nowe wystąpienie klasy |
| ComClassAttribute(String, String, String) |
Inicjuje nowe wystąpienie klasy |
| ComClassAttribute(String, String) |
Inicjuje nowe wystąpienie klasy |
| ComClassAttribute(String) |
Inicjuje nowe wystąpienie klasy |
Właściwości
| Nazwa | Opis |
|---|---|
| ClassID |
Pobiera identyfikator klasy używany do unikatowego identyfikowania klasy. |
| EventID |
Pobiera identyfikator zdarzenia używany do unikatowego identyfikowania zdarzenia. |
| InterfaceID |
Pobiera identyfikator interfejsu używany do unikatowego identyfikowania interfejsu. |
| InterfaceShadows |
Wskazuje, że nazwa interfejsu COM w tle innego elementu członkowskiego klasy lub klasy bazowej. |
| TypeId |
Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attribute. (Odziedziczone po Attribute) |
Metody
| Nazwa | Opis |
|---|---|
| Equals(Object) |
Zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute) |
| GetHashCode() |
Zwraca kod skrótu dla tego wystąpienia. (Odziedziczone po Attribute) |
| GetType() |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
| IsDefaultAttribute() |
Po zastąpieniu w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute) |
| Match(Object) |
Po zastąpieniu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Jawne implementacje interfejsu
| Nazwa | Opis |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Pobiera informacje o typie obiektu, którego można użyć do uzyskania informacji o typie dla interfejsu. (Odziedziczone po Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Zapewnia dostęp do właściwości i metod uwidocznionych przez obiekt. (Odziedziczone po Attribute) |