Freigeben über


Erstellen primärer Interop-Assemblys

Aktualisiert: November 2007

Primäre Interop-Assemblys werden von demselben Herausgeber 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 beim Verfügbarmachen von COM-Komponenten für .NET Framework.

Primäre Interop-Assemblys 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 Kryptografiestandards 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-Assemblys 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 Assemblys 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 Bereitstellen bearbeiten, um spätere Versionen unterscheiden zu können.

Siehe auch

Konzepte

Benennen primärer Interop-Assemblys

Generieren primärer Interop-Assemblys

Anpassen primärer Interop-Assemblys

Verteilen primärer Interop-Assemblys an Entwickler

Weitere Ressourcen

Primäre Interop-Assemblys