/linkresource (C#-Compileroptionen)
Erstellt einen Link zu einer .NET Framework-Ressource in der Ausgabedatei. Der Ausgabedatei wird die Ressourcendatei nicht hinzugefügt. Dies unterscheidet von der /resource-Option, die eine Ressourcendatei in die Ausgabedatei einbettet.
/linkresource:filename[,identifier[,accessibility-modifier]]
Argumente
filename
die .NET Framework-Ressourcendatei, zu der Sie von der Assembly aus eine Verknüpfung erstellen möchten.identifier (optional)
Der logische Name der Ressource. Dieser wird zum Laden der Ressource verwendet. Der Standardwert ist der Dateiname.accessibility-modifier (optional)
Der Zugriff auf die Ressource: public oder private. Der Standard lautet public.
Hinweise
Verknüpfte Ressourcen sind in der Assembly automatisch öffentlich, wenn sie mit dem C#-Compiler erstellt wurden. Um die Ressource auf private umzustellen, geben Sie private als Zugriffsmodifizierer an. Andere Modifizierer als public oder private sind nicht zugelassen.
Die Option /linkresource erfordert eine andere /target-Option als /target:module.
Wenn filename einer .NET Framework-Ressourcendatei entspricht, die beispielsweise durch Resgen.exe oder in der Entwicklungsumgebung erstellt wurde, kann mit Membern im System.Resources-Namespace darauf zugegriffen werden. Weitere Informationen finden Sie unter System.Resources.ResourceManager. Für alle anderen Ressourcen verwenden Sie die GetManifestResource*-Methoden in der Assembly-Klasse, um die Ressource zur Laufzeit aufzurufen.
Die unter filename angegebene Datei kann in beliebigem Format vorliegen. Sie können beispielsweise eine systemeigene DLL zum Bestandteil der Assembly machen, damit sie im globalen Assemblycache installiert und aus verwaltetem Code in der Assembly darauf zugegriffen werden kann. Im zweiten der folgenden Beispiele wird gezeigt, wie Sie dafür vorgehen müssen. Dies ist auch im Assemblylinker möglich. Dies wird im dritten der folgenden Beispiele gezeigt. Weitere Informationen finden Sie unter Al.exe (Assembly Linker-Tool) und Arbeiten mit Assemblys und dem globalen Assemblychache.
/linkres ist die Kurzform von /linkresource.
Diese Compileroption steht in Visual Studio nicht zur Verfügung. Sie kann nicht programmgesteuert geändert werden.
Beispiel
In diesem Beispiel wird in.cs kompiliert und mit der Ressourcendatei rf.resource verknüpft:
csc /linkresource:rf.resource in.cs
Kompilieren Sie A.cs in eine DLL, verknüpfen Sie sie mit einer systemeigenen DLL N.dll, und legen Sie die Ausgabe im globalen Assemblycache (GAC) ab. In diesem Beispiel befinden sich sowohl A.dll als auch N.dll im globalen Assemblycache.
csc /linkresource:N.dll /t:library A.cs
gacutil -i A.dll
Bei diesem Beispiel ist das Ergebnis mit dem vorherigen identisch, allerdings werden nun die Assemblylinkeroptionen verwendet.
csc /t:module A.cs
al /out:A.dll A.netmodule /link:N.dll
gacutil -i A.dll