InterfaceTypeAttribute 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.
Wskazuje, czy interfejs zarządzany jest podwójny, tylko do wysyłania, czy IUnknown
tylko w przypadku uwidocznienia w modelu COM.
public ref class InterfaceTypeAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)]
public sealed class InterfaceTypeAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class InterfaceTypeAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)>]
type InterfaceTypeAttribute = class
inherit Attribute
[<System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type InterfaceTypeAttribute = class
inherit Attribute
Public NotInheritable Class InterfaceTypeAttribute
Inherits Attribute
- Dziedziczenie
- Atrybuty
Przykłady
W poniższym przykładzie pokazano, jak InterfaceTypeAttribute
steruje sposobem uwidocznienia interfejsu w modelu COM.
using namespace System::Runtime::InteropServices;
//Interface is exposed to COM as dual.
interface class IMyInterface1{};
//Insert code here.
//Interface is exposed to COM as IDispatch.
[InterfaceTypeAttribute(ComInterfaceType::InterfaceIsIDispatch)]
interface class IMyInterface2{};
//Insert code here.
using System.Runtime.InteropServices;
//Interface is exposed to COM as dual.
interface IMyInterface1
{
//Insert code here.
}
//Interface is exposed to COM as IDispatch.
[InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIDispatch)]
interface IMyInterface2
{
//Insert code here.
}
Imports System.Runtime.InteropServices
'Interface is exposed to COM as dual.
Interface IMyInterface1
'Insert code here.
End Interface
'Interface is exposed to COM as IDispatch.
<InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIDispatch)> _
Interface IMyInterface2
'Insert code here.
End Interface
Uwagi
Ten atrybut można zastosować do interfejsów.
Domyślnie Tlbexp.exe (eksporter biblioteki typów) uwidacznia zarządzany interfejs COM jako podwójny interfejs, co zapewnia elastyczność późnego powiązania lub wydajność wczesnego powiązania. Wyliczenie ComInterfaceType umożliwia zastąpienie domyślnego zachowania i określenie tylko późnego powiązania lub tylko wczesnego powiązania. Na przykład można zastosować do InterfaceType (ComInterfaceType.InterfaceIsIDispatch)
interfejsu w celu utworzenia metadanych w celu ograniczenia wywołań tylko do późnego powiązania. Chociaż interfejsy pochodzące z interfejsu IDispatch
są często podwójne, InterfaceIsIDispatch
element członkowski wyliczenia umożliwia tylko późne wywołania do metod interfejsu. Ten atrybut nie ma wpływu na zarządzany widok interfejsu. Aby uzyskać dodatkowe informacje na temat sposobu uwidaczniania interfejsów w modelu COM, zobacz Eksportowanie konwersji typów.
Tlbimp.exe (importer biblioteki typów) stosuje również ten atrybut do importowanych, nieuwzalnych interfejsów; stosuje odpowiedni element członkowski wyliczenia, aby wskazać, że interfejs jest tylko do wysyłania lub IUnknown
tylko .
Konstruktory
InterfaceTypeAttribute(ComInterfaceType) |
Inicjuje InterfaceTypeAttribute nowe wystąpienie klasy z określonym ComInterfaceType elementem członkowskim wyliczenia. |
InterfaceTypeAttribute(Int16) |
Inicjuje InterfaceTypeAttribute nowe wystąpienie klasy z określonym ComInterfaceType elementem członkowskim wyliczenia. |
Właściwości
TypeId |
Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute) |
Value |
ComInterfaceType Pobiera wartość opisaną sposób uwidocznienia interfejsu w modelu COM. |
Metody
Equals(Object) |
Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute) |
GetHashCode() |
Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
IsDefaultAttribute() |
Podczas zastępowania w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej. (Odziedziczone po Attribute) |
Match(Object) |
Po przesłonięciu 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 Objectelementu . (Odziedziczone po Object) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Jawne implementacje interfejsu
_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 dla obiektu, który może służyć do pobierania 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) |
Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute) |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla