Génération d'assemblys PIA (Primary Interop Assembly)
Les assemblys PIA 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. La génération et la distribution d'un assembly PIA est une étape essentielle de l'exposition de composants COM au .NET Framework.
Les assemblys PIA doivent répondre aux exigences suivantes :
Inclure tous les types COM définis dans la bibliothèque de types d'origine et conserver les mêmes identités GUID.
Être signés avec un nom fort à l'aide du chiffrement de clé publique standard.
Contient l'attribut PrimaryInteropAssemblyAttribute.
Éviter de redéfinir des types COM externes.
Ne référencer que d'autres assemblys PIA pour des dépendances COM externes.
Une définition de type unique garantit que toutes les applications .NET Framework créent une liaison au même type au moment de la compilation et que le type est marshalé de la même manière au moment de l'exécution. Il est important de ne créer qu'un seul assembly PIA pour chaque bibliothèque de types COM car plusieurs assemblys peuvent provoquer une incompatibilité de types.
Pour améliorer l'interopérabilité, vous pouvez personnaliser les noms et le comportement de marshaling des types individuels. Si vous révisez un assembly PIA après l'avoir envoyé, incrémentez le numéro de version de l'assembly pour différencier les versions ultérieures.
Voir aussi
Concepts
Attribution d'un nom aux assemblys PIA
Personnalisation d'assemblys PIA
Distribution d'assemblys PIA aux développeurs