Partager via


/linkresource (Options du compilateur C#)

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 Al.exe (Assembly Linker) et Utilisation d'assemblys et du Global Assembly Cache.

/linkres est la forme abrégée de /linkresource.

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

Voir aussi

Tâches

Comment : modifier des propriétés de projet et des paramètres de configuration

Référence

Al.exe (Assembly Linker)

Autres ressources

Options du compilateur C#

Utilisation d'assemblys et du Global Assembly Cache