InterfaceTypeAttribute Classe

Définition

Espace de noms:

System.Runtime.InteropServices

Assemblys:

netstandard.dll, System.Runtime.InteropServices.dll

Source:

InterfaceTypeAttribute.cs

Indique si une interface managée est double, distribuée uniquement ou IUnknown -only 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)>]
type InterfaceTypeAttribute = class
    inherit Attribute

Public NotInheritable Class InterfaceTypeAttribute
Inherits Attribute

Héritage

Object

Attribute

InterfaceTypeAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant montre comment contrôler la façon dont InterfaceTypeAttribute 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èque de types) expose une interface managée à COM en tant qu’interface double, ce qui vous donne la flexibilité de la liaison tardive ou des performances de la liaison anticipée. L’énumération ComInterfaceType vous permet de remplacer le comportement par défaut et de spécifier la liaison tardive uniquement ou la liaison anticipée uniquement. Par exemple, vous pouvez appliquer InterfaceType (ComInterfaceType.InterfaceIsIDispatch) à une interface pour produire des métadonnées pour restreindre les appelants à la liaison tardive uniquement. Bien que les interfaces qui dérivent de l’interface IDispatch soient souvent doubles, le InterfaceIsIDispatch membre d’énumération 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é).

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

Constructeurs

Nom	Description
InterfaceTypeAttribute(ComInterfaceType)	Initialise une nouvelle instance de la InterfaceTypeAttribute classe avec le membre d’énumération spécifié ComInterfaceType .
InterfaceTypeAttribute(Int16)	Initialise une nouvelle instance de la InterfaceTypeAttribute classe avec le membre d’énumération spécifié ComInterfaceType .

Propriétés

Nom	Description
TypeId	En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute)
Value	Obtient la ComInterfaceType valeur qui décrit la façon dont l’interface doit être exposée à COM.

Méthodes

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

Voir aussi

• ComInterfaceType
• Tlbexp.exe (exportateur de bibliothèque de types)
• Tlbimp.exe (importateur de bibliothèques de types)