Benennen primärer Interop-Assemblys
Aktualisiert: November 2007
Zur einfachen Erkennung sollten Sie für eine primäre Interop-Assembly einen Namen wählen, der dem Namen der ursprünglichen COM-Typbibliothek ähnelt und aussagekräftig genug ist, damit Entwickler diese leicht finden können. Wie bei anderen Assemblys hat der Name der primären Interop-Assembly großen Einfluss auf den Gültigkeitsbereich und die Verwendung der Assembly durch mehrere Anwendungen.
Sie definieren den Namen beim Generieren der primären Interop-Assembly. In der Regel generieren Sie eine primäre Interop-Assembly durch das Importieren einer Typbibliothek. Einzelheiten über das Importieren einer Typbibliothek finden Sie unter Generieren primärer Interop-Assemblys.
Benennen von Elementen
Primäre Interop-Assemblys müssen unter Verwendung der Standardkrypographie für öffentliche Schlüssel mit einem starken Namen signiert sein. Zusätzlich zum öffentlichen Schlüssel gibt es zwei wichtige Elemente für das Benennen:
Name der Assemblydatei.
Der Dateiname der Assembly muss mit dem Assemblynamen übereinstimmen (ohne die Dateinamenerweiterung wie EXE oder DLL). Beim Importieren wird i. d. R. der Name der Typbibliothek anstelle des Namens der Typbibliotheksdatei verwendet, um den Assemblynamen und den Dateinamen zu erstellen. Der Name der Typbibliothek und der Name der Typbibliotheksdatei sind nicht unbedingt identisch. Wenn Sie z. B. die in der Datei MyComponent.tlb enthaltene Typbibliothek MyTypeLib importieren, lautet der Assemblyname in der Voreinstellung MyTypeLib und der Name der Assemblydatei MyTypeLib.dll.
Verwenden Sie als allgemeine Richtlinie die Kombination Herstellername.Bibliotheksname, um eine primäre Interop-Assembly zu kennzeichnen. Zum vollständigen Kennzeichnen der durch MyCompany veröffentlichten Typbibliothek MyTypeLib sollten Sie z. B. den Standardnamen der Assemblydatei (MyTypeLib.dll) beim Importieren der Typbibliothek mit MyCompany.MyTypeLib.dll überschreiben.
Namespacename.
Beim Importieren einer Typbibliothek wird mit dem Namen der Typbibliothek der Namespacename erstellt. Durch das Überschreiben des Standardnamespaces während des Importierens können Sie den Namespacenamen angeben. Verwenden Sie für den Namespace dieselbe Namenskonvention (Herstellername.Bibliotheksname), die Sie für den Assemblynamen verwendet haben.
Überlegungen zur Benennung
Berücksichtigen Sie bei der Benennung die folgenden Punkte:
Möglicherweise möchten Sie in der Zukunft eine verwaltete Version einer vorhandenen COM-technologie implementieren. Verwenden Sie in diesem Fall die Kombination Herstellername.Bibliotheksname.Interop für den Namespace der primären Interop-Assembly, und reservieren Sie Herstellername.Bibliotheksname für die verwaltete Assembly.
Sie können die Benennung auch so durchführen, dass Sie die Kompatibilität zwischen der ursprünglichen COM-Typbibliothek und der primären Assembly gewährleisten, indem Sie den Standardassemblynamen, -dateinamen und -namespacenamen verwenden. Diese Namen sind zwar weniger aussagekräftig, aber bei bekannten Bibliotheken wie ADODB in Microsoft Visual Basic 6.0 (die ADO-Bibliothek) sehr nützlich.
Siehe auch
Konzepte
Erstellen primärer Interop-Assemblys
Generieren primärer Interop-Assemblys