PrimaryInteropAssemblyAttribute Classe

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Source:

PrimaryInteropAssemblyAttribute.cs

Indique que l'assembly avec attributs est un assembly PIA (Primary Interop Assembly).

public ref class PrimaryInteropAssemblyAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true, Inherited=false)]
public sealed class PrimaryInteropAssemblyAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true, Inherited=false)>]
type PrimaryInteropAssemblyAttribute = class
    inherit Attribute

Public NotInheritable Class PrimaryInteropAssemblyAttribute
Inherits Attribute

Héritage

Object

Attribute

PrimaryInteropAssemblyAttribute

Attributs

AttributeUsageAttribute

Remarques

Vous pouvez appliquer cet attribut aux assemblys, bien que le Tlbimp.exe (importateur de bibliothèque de types) l’applique généralement pour vous quand il importe une bibliothèque de types.

Un assembly d’interopérabilité contient des métadonnées qui décrivent les types COM existants, qui sont souvent déjà décrits dans une bibliothèque de types COM. Tlbimp.exe produit des assemblys d’interopérabilité à partir de bibliothèques de types COM. Les assemblys d’interopérabilité contiennent généralement uniquement des métadonnées (pas de code). Les assemblys d’interopérabilité primaire sont fournis par le même éditeur que la bibliothèque de types qu’ils décrivent et fournissent les définitions officielles des types définis avec cette bibliothèque de types. Les assemblys d’interopérabilité principale sont toujours signés par leur éditeur pour garantir l’unicité.

Vous pouvez générer un assembly d’interopérabilité primaire à partir d’une bibliothèque de types des manières suivantes :

• Exécutez TlbImp.exe avec l’option /primary à partir de la ligne de commande.

• Appliquez au moment du PrimaryInteropAssemblyAttribute design.

Pour spécifier un assembly d’interopérabilité primaire dans le code source managé, vous devez appliquer et System.Runtime.InteropServices.GuidAttributePrimaryInteropAssemblyAttribute à l’assembly au moment de la conception. Le GuidAttribute sur l’assembly d’interopérabilité primaire identifie le LIBID de la bibliothèque de types et le PrimaryInteropAssemblyAttribute identifie la version de la bibliothèque de types particulière pour laquelle cet assembly est l’assembly d’interopérabilité primaire. Le PrimaryInteropAssemblyAttribute peut apparaître plusieurs fois si l’assembly est l’assembly d’interopérabilité principal pour plusieurs versions de la même bibliothèque de type.

Lorsque vous utilisez les types définis dans une bibliothèque de types, référencez toujours l’assembly d’interopérabilité primaire pour cette bibliothèque de types, au lieu de réimporter ou de redéfinir les types eux-mêmes. Pour obtenir des instructions et des procédures sur la façon de produire ou d’utiliser des assemblys d’interopérabilité primaire, consultez Primary Interop Assemblies. Pour obtenir une description détaillée du processus d’importation de bibliothèque de types, consultez Résumé de la conversion de bibliothèque de types en assembly.

Constructeurs

PrimaryInteropAssemblyAttribute(Int32, Int32)

Initialise une nouvelle instance de la classe PrimaryInteropAssemblyAttribute avec les numéros de versions principale et secondaire de la bibliothèque de types pour laquelle l'assembly est l'assembly PIA (Primary Interop Assembly).

Propriétés

MajorVersion	Obtient le numéro de version principale de la bibliothèque de types pour laquelle cet assembly est l'assembly PIA (Primary Interop Assembly).
MinorVersion	Obtient le numéro de version secondaire de la bibliothèque de types pour laquelle cet assembly est l'assembly PIA (Primary Interop Assembly).
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

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)

Voir aussi

• GuidAttribute
• Tlbimp.exe (Type Library Importer)