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.

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* de 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.

/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.

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édant, 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

Référence

Autres ressources