/KEYFILE (Schlüsselcontainer oder Schlüsselpaar zum Signieren einer Assembly festlegen)
Aktualisiert: November 2007
/KEYFILE:filename
Hinweise
Dabei gilt:
- filename
Die Datei, die den Schlüssel enthält. Schließen Sie die Zeichenfolge in doppelte Anführungszeichen (" ") ein, wenn sie ein Leerzeichen enthält.
Hinweise
Der Linker fügt den öffentlichen Schlüssel in das Assemblymanifest ein und signiert dann die endgültige Assembly mit dem privaten Schlüssel. Geben Sie sn -k file in der Befehlszeile ein, um eine Schlüsseldatei zu erstellen. Namen signierter Assemblys werden als starke Namen bezeichnet.
Bei der Kompilierung mit /LN wird der Name der Schlüsseldatei im Modul beibehalten und in eine Assembly eingefügt. Letztere wird erstellt, wenn Sie eine Assembly, die einen expliziten Verweis auf das Modul enthält, mittels #using kompilieren oder eine Verknüpfung mit /ASSEMBLYMODULE herstellen.
Die Verschlüsselungsinformationen können auch mit /KEYCONTAINER an den Linker übergeben werden. Verwenden Sie /DELAYSIGN, wenn die Assembly teilweise signiert werden soll. Weitere Informationen über das Signieren einer Assembly finden Sie unter Assemblys mit starken Namen (Assemblysignierung).
Falls sowohl /KEYFILE als auch /KEYCONTAINER angegeben werden (entweder als Befehlszeilenoption oder als benutzerdefiniertes Attribut), versucht der Linker zunächst, Daten vom Schlüsselcontainer abzurufen. Wenn dies erfolgreich ist, wird die Assembly mit den Informationen aus dem Schlüsselcontainer signiert. Wenn der Schlüsselcontainer nicht gefunden wird, versucht der Linker, Daten aus der mit /KEYFILE festgelegten Datei abzurufen. Ist dies erfolgreich, wird die Assembly mit den Informationen in der Schlüsseldatei signiert, und die Schlüsselinformationen werden in den Schlüsselcontainer installiert (ähnlich wie mit sn -i), sodass der Schlüsselcontainer bei der nächsten Kompilierung gültig ist.
Beachten Sie, dass eine Schlüsseldatei möglicherweise nur den öffentlichen Schlüssel enthält.
Weitere Informationen über das Signieren einer Assembly finden Sie unter Erstellen und Verwenden von Assemblys mit starkem Namen.
Folgende Linkeroptionen beeinflussen außerdem das Erstellen von Assemblys:
So legen Sie diese Linkeroption in der Visual Studio-Entwicklungsumgebung fest
Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Ausführliche Informationen finden Sie unter Festlegen von Visual C++-Projekteigenschaften.
Klicken Sie auf den Ordner Linker.
Klicken Sie auf die Eigenschaftenseite für die Befehlszeile.
Geben Sie die Option im Feld Zusätzliche Optionen ein.
So legen Sie diese Linkeroption programmgesteuert fest
- Siehe AdditionalOptions.