/linkresource (Lien vers une ressource du .NET Framework) (Options du compilateur C#)
Mise à jour : novembre 2007
Crée un lien vers une ressource .NET Framework dans le fichier de sortie. Le fichier de ressources n'est pas ajouté au fichier de sortie. Cela diffère de l'option /resource qui incorpore un fichier de ressources dans un fichier de sortie.
/linkresource:filename[,identifier[,accessibility-modifier]]
Arguments
filename
Fichier de ressources .NET Framework avec lequel vous voulez établir un lien à partir de l'assembly.identifier (facultatif)
Nom logique de la ressource, c'est-à-dire le nom utilisé pour charger cette dernière. La valeur par défaut est le nom du fichier.accessibility-modifier (facultatif)
Accessibilité de la ressource : public ou private. La valeur par défaut est public.
Notes
Par défaut, les ressources liées sont public dans l'assembly lorsqu'elles sont créées avec le compilateur C#. Pour que les ressources soient private, spécifiez private comme modificateur d'accessibilité. Aucun autre modificateur que public ou private n'est autorisé.
L'option /linkresource nécessite une option /target différente de /target:module.
Si filename est un fichier de ressources .NET Framework créé, par exemple, par Resgen.exe ou dans l'environnement de développement, il est accessible avec des membres dans l'espace de noms System.Resources. Pour plus d'informations, consultez System.Resources.ResourceManager. Pour toutes les autres ressources, utilisez les méthodes GetManifestResource* dans la classe Assembly pour accéder à la ressource au moment de l'exécution.
Le fichier spécifié par filename peut avoir n'importe quel format. Par exemple, vous pouvez décider d'intégrer une DLL native dans l'assembly. Ainsi, elle pourra être installée dans le Global Assembly Cache et sera accessible depuis le code managé de l'assembly. La procédure ci-après indique comment effectuer cette opération. Vous pouvez faire la même chose dans Assembly Linker. La procédure ci-après indique comment effectuer cette opération. Pour plus d'informations, consultez Assembly Linker (Al.exe) et Utilisation d'assemblys et du Global Assembly Cache.
La forme abrégée de /linkresource est /linkres.
Cette option du compilateur n'est pas disponible dans Visual Studio et ne peut pas être modifiée par programme.
Exemple
Compilez in.cs et liez ce fichier au fichier de ressources rf.resource :
csc /linkresource:rf.resource in.cs
Compilez A.cs dans une DLL, liez à une DLL native N.dll et placez la sortie dans le GAC (Global Assembly Cache). Dans cet exemple, A.dll et N.dll résideront dans le GAC.
csc /linkresource:N.dll /t:library A.cs
gacutil -i A.dll
Cet exemple effectue la même opération que le précédent, mais en utilisant les options Assembly Linker.
csc /t:module A.cs
al /out:A.dll A.netmodule /link:N.dll
gacutil -i A.dll