Vorgehensweise: Verweisen auf eine Assembly mit starkem Namen

  • Artikel

Beim Verweisen auf Typen oder Ressourcen in einer Assembly mit starkem Namen handelt es sich in der Regel um einen transparenten Prozess. Sie können den Verweis zur Kompilierzeit (frühes Binden) oder zur Runtime vornehmen.

Ein Verweis zur Kompilierzeit tritt auf, wenn Sie den Compiler darauf hinweisen, dass die Assembly, die kompiliert werden soll, explizit auf eine andere Assembly verweist. Beim Verweisen zur Kompilierzeit ruft der Compiler automatisch den öffentlichen Schlüssel der Zielassembly mit starkem Namen ab und platziert ihn in der Assemblyreferenz der Assembly, die aktuell kompiliert wird.

Hinweis

Eine Assembly mit starkem Namen kann nur Typen aus anderen Assemblys mit starkem Namen verwenden. Andernfalls ist die Sicherheit der Assembly mit starkem Namen beeinträchtigt.

Verweisen auf eine Assembly mit starkem Namen zur Kompilierzeit

Geben Sie an einer Eingabeaufforderung folgenden Befehl ein:

<Compilerbefehl>/reference:<Assemblyname>

In diesem Befehl ist der Compilerbefehl der Befehl für die Sprache, die Sie verwenden, und Assemblyname ist der Name der Assembly mit starkem Namen, auf die verwiesen wird. Sie können auch andere Compileroptionen verwenden, z.B. die Option /t:library zum Erstellen einer Bibliothekassembly.

Im folgenden Beispiel wird die Assembly myAssembly.dll erstellt, die auf die Assembly mit dem starkem Namen myLibAssembly.dll aus dem Codemodul myAssembly.cs verweist.

csc /t:library myAssembly.cs /reference:myLibAssembly.dll

Verweisen auf eine Assembly mit starkem Namen zur Laufzeit

Wenn Sie zur Laufzeit auf eine Assembly mit starkem Namen verweisen (z. B. mit der Assembly.Load- oder Assembly.GetType-Methode), müssen Sie den Anzeigenamen der Assembly mit starkem Namen verwenden, auf die verwiesen wird. Die Syntax eines Anzeigenamens lautet wie folgt:

<Assemblyname>,<Versionsnummer>,<Kultur>,<öffentliches Schlüsseltoken>

Zum Beispiel:

myDll, Version=1.1.0.0, Culture=en, PublicKeyToken=03689116d3a4ae33

In diesem Beispiel ist PublicKeyToken die hexadezimale Form des öffentlichen Schlüsseltokens. Wenn kein Kulturwert vorhanden ist, verwenden Sie Culture=neutral.

Im folgenden Codebeispiel wird gezeigt, wie Sie diese Informationen mit der Assembly.Load-Methode verwenden.

Assembly^ myDll =
    Assembly::Load("myDll, Version=1.0.0.1, Culture=neutral, PublicKeyToken=9b35aa32c18d4fb1");

Assembly myDll =
    Assembly.Load("myDll, Version=1.0.0.1, Culture=neutral, PublicKeyToken=9b35aa32c18d4fb1");

Dim myDll As Assembly = _
    Assembly.Load("myDll, Version=1.0.0.1, Culture=neutral, PublicKeyToken=9b35aa32c18d4fb1")

Sie können das Hexadezimalformat des öffentlichen Schlüssels und des öffentlichen Schlüsseltokens für eine bestimmte Assembly mithilfe des folgenden Befehls Strong Name (Sn.exe) ausgeben:

sn -Tp <Assembly>

Wenn Sie eine öffentliche Schlüsseldatei haben, können Sie stattdessen den folgenden Befehl verwenden. Beachten Sie aber den Unterschied bei der Groß- und Kleinschreibung bei der Befehlszeilenoption:

sn -tp <öffentliche Schlüsseldatei>

Siehe auch