-linkresource (Visual Basic)

Crée un lien à une ressource managée.

Syntaxe

-linkresource:filename[,identifier[,public|private]]  

ou

-linkres:filename[,identifier[,public|private]]  

Arguments

filename
Obligatoire. Le fichier de ressources à lier à l’assembly. Si le nom de fichier contient un espace, placez-le entre des guillemets (« »).

identifier
Optionnel. Nom logique pour la ressource. Nom utilisé pour charger la ressource. La valeur par défaut est le nom du fichier. Si vous le souhaitez, vous pouvez spécifier si le fichier est public ou privé dans le manifeste de l’assembly, par exemple : -linkres:filename.res,myname.res,public. Par défaut, filename est public dans l’assembly.

Notes

L’option -linkresource n’incorpore pas le fichier de ressources dans le fichier de sortie ; pour ce faire, utilisez l’option -resource.

L’option -linkresource nécessite l’une des options -target autres que -target:module.

Si filename est un fichier de ressources du .NET Framework créé, par exemple, par l’outil Resgen.exe (Resource File Generator) ou dans l’environnement de développement, il est possible d’y accéder à l’aide des membres de l’espace de noms System.Resources. (Pour plus d’informations, consultez ResourceManager.) Pour accéder à toutes les autres ressources au moment de l’exécution, utilisez les méthodes qui commencent par GetManifestResource dans la classe Assembly.

Le nom de fichier peut être n’importe quel format de fichier. C’est le cas, par exemple, si vous voulez qu’une DLL native fasse partie de l'assembly pour qu’elle puisse être installée dans le Global Assembly Cache et accessible à partir du code managé dans l'assembly.

La forme abrégée de -linkresource est -linkres.

Notes

L’option -linkresource n’est pas disponible à partir de l’environnement de développement Visual Studio ; elle est disponible uniquement lorsque vous compilez à partir de la ligne de commande.

Exemple

Le code suivant compile et établit in.vb et des liens vers le fichier de ressources rf.resource.

vbc -linkresource:rf.resource in.vb  

Voir aussi