InterfaceTypeAttribute Classe

Référence

Définition

Espace de noms:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: InterfaceTypeAttribute.cs

Source:: InterfaceTypeAttribute.cs

Source:: InterfaceTypeAttribute.cs

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.

Indique si une interface managée est double, de dispatch uniquement ou IUnknown uniquement lorsqu'elle est exposée à 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

Héritage: Object

Attribute
InterfaceTypeAttribute

Attributs: AttributeUsageAttribute ComVisibleAttribute

Exemples

L’exemple suivant montre comment InterfaceTypeAttribute contrôle la façon dont l’interface est exposée à 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

Remarques

Vous pouvez appliquer cet attribut aux interfaces.

Par défaut, le Tlbexp.exe (exportateur de bibliothèques de types) expose une interface managée à COM en tant qu’interface double, ce qui vous offre la flexibilité d’une liaison tardive ou des performances de liaison anticipée. L’énumération ComInterfaceType vous permet de remplacer le comportement par défaut et de spécifier une liaison tardive uniquement ou une liaison anticipée uniquement. Par exemple, vous pouvez appliquer InterfaceType (ComInterfaceType.InterfaceIsIDispatch) à une interface pour produire des métadonnées afin de limiter les appelants à la liaison tardive uniquement. Bien que les interfaces qui dérivent de l’interface IDispatch soient souvent doubles, le membre d’énumération InterfaceIsIDispatch autorise uniquement les appels à liaison tardive aux méthodes d’interface. Cet attribut n’a aucun effet sur la vue managée de l’interface. Pour plus d’informations sur la façon dont les interfaces sont exposées à COM, consultez Conversion de type exportée.

Le Tlbimp.exe (importateur de bibliothèque de types) applique également cet attribut aux interfaces non virtuelles importées ; il applique le membre d’énumération approprié pour indiquer que l’interface est dispatch-only ou IUnknown -only.

Constructeurs

InterfaceTypeAttribute(ComInterfaceType)	Initialise une nouvelle instance de la classe InterfaceTypeAttribute avec le membre de l'énumération ComInterfaceType spécifié.
InterfaceTypeAttribute(Int16)	Initialise une nouvelle instance de la classe InterfaceTypeAttribute avec le membre de l'énumération ComInterfaceType spécifié.

Propriétés

TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)
Value	Obtient la valeur ComInterfaceType qui décrit comment l'interface doit être exposée à COM.

Méthodes

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 de cette instance. (Hérité de Attribute)
GetType()	Obtient le 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 pour la classe dérivée. (Hérité de Attribute)
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

_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 pour 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 aux méthodes exposées par un objet. (Hérité de Attribute)

S’applique à

Partager via