Partager via


Application d'attributs d'interopérabilité

Mise à jour : novembre 2007

L'espace de noms System.Runtime.InteropServices propose trois catégories d'attributs spécifiques à l'interopérabilité : ceux que vous appliquez au moment du design, ceux que les interfaces API et les outils de COM Interop appliquent au cours du processus de conversion et ceux que vous appliquez ou que COM Interop applique.

Si vous n'êtes pas habitué aux tâches relatives à l'application d'attributs à du code managé, consultez Extension des métadonnées à l'aide des attributs. Comme pour les autres attributs personnalisés, vous pouvez appliquer des attributs spécifiques à l'interopérabilité à des types, à des méthodes, à des paramètres, à des propriétés, à des champs et à d'autres membres.

Attributs en mode design

Vous pouvez ajuster le résultat du processus de conversion effectué par les interfaces API et les outils de COM Interop à l'aide d'attributs en mode design. Le tableau suivant décrit les attributs que vous pouvez appliquer à votre code source managé. Les outils de COM Interop peuvent également parfois appliquer les attributs décrits dans ce tableau.

Attribut

Description

AutomationProxyAttribute

Spécifie que le type doit être marshalé à l'aide du marshaleur Automation ou d'un stub et d'un proxy personnalisés.

ClassInterfaceAttribute

Contrôle le type d'interface généré pour une classe.

CoClassAttribute

Identifie le CLSID de la coclasse d'origine importée à partir d'une bibliothèque de types.

Les outils de COM Interop appliquent généralement cet attribut.

ComImportAttribute

Indique qu'une coclasse ou qu'une définition d'interface a été importée à partir d'une bibliothèque de types COM. Le runtime utilise cet indicateur pour savoir comment activer et marshaler le type. Cet attribut interdit au type d'être de nouveau exporté vers une bibliothèque de types.

Les outils de COM Interop appliquent généralement cet attribut.

ComRegisterFunctionAttribute

Indique qu'une méthode doit être appelée lorsque l'assembly est inscrit en vue de son utilisation à partir de COM, de sorte que le code écrit par l'utilisateur puisse être exécuté au cours du processus d'inscription.

ComSourceInterfacesAttribute

Identifie les interfaces qui sont des sources d'événements pour la classe.

Les outils de COM Interop peuvent appliquer cet attribut.

ComUnregisterFunctionAttribute

Indique qu'une méthode doit être appelée lorsque l'inscription de l'assembly dans COM est annulée, de sorte que le code écrit par l'utilisateur puisse s'exécuter au cours du processus.

ComVisibleAttribute

Rend les types invisibles à COM lorsque l'attribut a la valeur false. Cet attribut peut être appliqué à un type individuel ou à l'intégralité de l'assembly pour contrôler la visibilité COM. Par défaut, tous les types publics managés sont visibles ; l'attribut n'est pas nécessaire pour les rendre visibles.

DispIdAttribute

Spécifie l'identificateur de dispatch COM (DISPID) d'une méthode ou d'un champ. Cet attribut contient le DISPID de la méthode, du champ ou de la propriété qu'il décrit.

Les outils de COM Interop peuvent appliquer cet attribut.

FieldOffsetAttribute

Indique la position physique de chaque champ dans une classe en cas d'utilisation avec StructLayoutAttribute et d'affectation d'Explicit à LayoutKind.

GuidAttribute

Spécifie l'identificateur global unique (GUID, Globally Unique Identifier) d'une classe, d'une interface ou d'une bibliothèque de types toute entière. La chaîne doit être passée à l'attribut sous la forme d'un argument de constructeur acceptable pour le type System.Guid.

Les outils de COM Interop peuvent appliquer cet attribut.

IDispatchImpAttribute

Indique l'implémentation d'interface IDispatch utilisée par le Common Language Runtime lors de l'exposition d'interfaces doubles et de dispinterfaces à COM.

InAttribute

Indique que des données doivent être marshalées dans l'appelant. Peut s'utiliser pour attribuer des paramètres.

InterfaceTypeAttribute

Contrôle le mode d'exposition d'une interface managée à des clients COM (Dual, dérivée d'IUnknown ou IDispatch uniquement).

Les outils de COM Interop peuvent appliquer cet attribut.

LCIDConversionAttribute

Indique que la signature d'une méthode non managée attend un paramètre LCID.

Les outils de COM Interop peuvent appliquer cet attribut.

MarshalAsAttribute

Indique le mode de marshaling des données figurant dans des champs ou des paramètres entre du code managé et non managé. L'attribut est toujours facultatif, car chaque type de données possède un comportement de marshaling par défaut.

Les outils de COM Interop peuvent appliquer cet attribut.

OptionalAttribute

Indique qu'un paramètre est facultatif.

Les outils de COM Interop peuvent appliquer cet attribut.

OutAttribute

Indique que les données d'un champ ou d'un paramètre doivent être remarshalées depuis un objet appelé vers son appelant.

PreserveSigAttribute

Supprime la transformation de la signature HRESULT ou retval qui s'effectue normalement au cours des appels d'interopérabilité. Cet attribut affecte le marshaling, ainsi que l'exportation des bibliothèques de types.

Les outils de COM Interop peuvent appliquer cet attribut.

ProgIdAttribute

Spécifie le ProgID d'une classe .NET Framework. Peut être utilisé pour des classes d'attribut.

StructLayoutAttribute

Contrôle l'agencement physique des champs d'une classe.

Les outils de COM Interop peuvent appliquer cet attribut.

Attributs d'outil de conversion

Le tableau suivant décrit les attributs que les outils de COM Interop appliquent au cours du processus de conversion. Vous n'appliquez pas ces attributs au moment du design.

Attribut

Description

ComAliasNameAttribute

Indique l'alias COM d'un type de paramètre ou de champ. Peut être utilisé pour des valeurs de retour, des champs ou des paramètres d'attribut.

ComConversionLossAttribute

Indique que des informations sur une classe ou une interface ont été perdues lors de leur importation d'une bibliothèque de types vers un assembly.

ComEventInterfaceAttribute

Identifie l'interface source et la classe qui implémente les méthodes de l'interface d'événements.

ImportedFromTypeLibAttribute

Indique que l'assembly a été importé à l'origine à partir d'une bibliothèque de types COM. Cet attribut contient la définition de la bibliothèque de types d'origines.

TypeLibFuncAttribute

Contient les FUNCFLAGS qui ont été importés à l'origine pour cette fonction à partir de la bibliothèque de types COM.

TypeLibTypeAttribute

Contient les TYPEFLAGS qui ont été importés à l'origine pour ce type à partir de la bibliothèque de types COM.

TypeLibVarAttribute

Contient les VARFLAGS qui ont été importés à l'origine pour cette variable à partir de la bibliothèque de types COM.

Voir aussi

Concepts

Exposition de composants .NET Framework à COM

Qualification des types .NET en vue d'une interopérabilité

Empaquetage d'un assembly pour COM

Référence

System.Runtime.InteropServices

Autres ressources

Extension des métadonnées à l'aide des attributs