Attribution d'un nom aux assemblys PIA
Pour reconnaître plus facilement un assembly PIA (Primary Interop Assembly), le nom que vous lui attribuez doit ressembler au nom de la bibliothèque de types COM d'origine et être suffisamment spécifique pour guider les développeurs vers l'assembly approprié. Comme pour d'autres assemblys, le nom d'un assembly PIA a un impact significatif sur sa portée et son utilisation par plusieurs applications.
Vous définissez le nom lorsque vous générez l'assembly PIA. En général, vous générez un assembly PIA en important une bibliothèque de types. Pour plus d'informations sur l'importation d'une bibliothèque de types, consultez Génération d'assemblys PIA.
Éléments essentiels dans l'affectation d'un nom
Les assemblys PIA (Primary Interop assembly) doivent être signés avec des noms forts à l'aide du chiffrement de clé publique standard. Outre la clé publique, deux éléments sont essentiels dans l'affectation d'un nom :
Nom de fichier de l'assembly.
Le nom de fichier de l'assembly doit correspondre au nom de l'assembly (sans inclure l'extension du nom de fichier, telle que .exe ou .dll). Par défaut, le processus d'importation utilise le nom de la bibliothèque de types, plutôt que celui du fichier de la bibliothèque de types, pour créer le nom et le nom de fichier de l'assembly. Le nom de la bibliothèque de types et son nom de fichier ne sont pas nécessairement identiques. Par exemple, si vous importez la bibliothèque de types MyTypeLib contenue dans le fichier MyComponent.tlb, le nom par défaut de votre assembly est MyTypeLib et le nom de fichier par défaut de votre assembly est MyTypeLib.dll.
En règle générale, utilisez la combinaison NomFabricant.NomBibliothèque pour identifier un assembly PIA. Par exemple, pour identifier parfaitement la bibliothèque de types MyTypeLib publiée par MyCompany, remplacez le nom de fichier par défaut de l'assembly (MyTypeLib.dll) par MyCompany.MyTypeLib.dll lorsque vous importez la bibliothèque de types.
Nom de l'espace de noms.
Lorsque vous importez une bibliothèque de types, le processus utilise le nom de celle-ci pour créer le nom de l'espace de noms. En remplaçant l'espace de noms par défaut pendant le processus d'importation, vous pouvez spécifier le nom de l'espace de noms. Utilisez la même convention d'affectation de noms pour l'espace de noms (NomFabricant.NomBibliothèque) que pour le nom de l'assembly.
Observations sur l'affectation de noms
Tenez compte des points suivants relatifs à l'affectation de noms :
Il se peut que vous souhaitiez, par la suite, implémenter une version managée d'une technologie COM existante. Dans ce cas, utilisez la combinaison d'espace de noms NomFabricant.NomBibliothèque.Interop pour votre assembly PIA et réservez NomFabricant.NomBibliothèque à l'assembly managé.
Votre stratégie d'affectation de noms peut également préserver la compatibilité source entre la bibliothèque de types COM d'origine et l'assembly PIA en utilisant le nom, le nom de fichier et le nom d'espace de noms par défaut de l'assembly. Bien que moins descriptive, cette stratégie est utile pour des bibliothèques connues, telles que ADODB dans Microsoft Visual Basic 6.0 (la bibliothèque ADO).
Voir aussi
Concepts
Génération d'assemblys PIA (Primary Interop Assembly)