Erstellen primärer Interop-Assemblies

Primäre Interop-Assemblies werden von demselben Publisher bereitgestellt wie die Typbibliothek, die sie beschreiben, und enthalten die offiziellen Definitionen der in dieser Typbibliothek definierten Typen. Das Erstellen und Verteilen einer primären Interop-Assembly ist ein wichtiger Schritt bei Entwickeln von COM-Komponenten für .NET Framework.

Primäre Interop-Assemblies müssen die folgenden Anforderungen erfüllen:

• Sie müssen alle COM-Typen enthalten, die in der ursprünglichen Typbibliothek definiert sind, und dieselben GUID-Identitäten verwalten.
• Sie müssen unter Verwendung von Kryptographiestandards für öffentliche Schlüssel mit einem starken Namen signiert sein.
• Sie müssen das PrimaryInteropAssemblyAttribute-Attribut enthalten.
• Das Neudefinieren externer COM-Typen muss vermieden werden.
• Verweise auf andere primäre Interop-Assemblies dürfen nur für externe COM-Abhängigkeiten erfolgen.

Durch die Verwendung nur einer Typdefinition wird sichergestellt, dass alle .NET Framework-Anwendungen bei der Kompilierung an denselben Typ gebunden werden und dass der Typ zur Laufzeit auf dieselbe Art gemarshallt wird. Für jede COM-Typbibliothek darf nur eine primäre Interop-Assembly erstellt werden, da mehrere Assemblies zu einer Inkompatibilität der Typen führen können.

Sie können die Namen und das Marshallingverhalten einzelner Typen anpassen, um die Interoperabilität zu verbessern. Erhöhen Sie die Nummer der Assemblyversion, wenn Sie eine primäre Interop-Assembly nach dem Weitergeben bearbeiten, um spätere Versionen unterscheiden zu können.

Siehe auch

Primäre Interop-Assemblies | Benennen primärer Interop-Assemblies | Generieren primärer Interop-Assemblies | Anpassen primärer Interop-Assemblies | Weitergeben primärer Interop-Assemblies an Entwickler