-reference (Visual Basic)

  • Article

Demande au compilateur de mettre les informations de type des assemblys spécifiés à la disposition du projet que vous êtes en train de compiler.

Syntaxe

-reference:fileList

ou

-r:fileList

Arguments

Terme Définition
fileList Obligatoire. Liste délimitée par des virgules des noms de fichiers d’assembly. Si le nom de fichier contient un espace, placez-le entre des guillemets.

Notes

Le ou les fichiers que vous importez doivent contenir des métadonnées d’assembly. Seuls les types publics sont visibles en dehors de l’assembly. L’option -addmodule importe les métadonnées d’un module.

Si vous référencez un assembly (Assembly A) qui référence un autre assembly (Assembly B), vous devez référencer l’Assembly B si :

  • Un type de l’Assembly A hérite d’un type ou implémente une interface de l’Assembly B.

  • Un champ, une propriété, un événement ou une méthode qui a un type de retour ou un type de paramètre de l’Assembly B est appelé.

Utilisez -libpath pour spécifier le répertoire dans lequel se trouvent une ou plusieurs références d’assembly.

Pour que le compilateur reconnaisse un type dans un assembly (et non un module), il doit être forcé de résoudre le type. Un exemple de la façon dont vous pouvez procéder consiste à définir une instance du type. D’autres méthodes sont disponibles pour résoudre les noms de types dans un assembly pour le compilateur. Par exemple, si vous héritez d’un type dans un assembly, le nom du type devient alors connu du compilateur.

Le fichier de réponse Vbc.rsp, qui référence les assemblys .NET Framework couramment utilisés, est utilisé par défaut. Utilisez -noconfig si vous ne souhaitez pas que le compilateur utilise Vbc.rsp.

La forme abrégée de -reference est -r.

Exemple

La commande suivante compile le fichier source Input.vb et des assemblies de référence à partir de Metad1.dll et de Metad2.dll pour produire Out.exe.

vbc -reference:metad1.dll,metad2.dll -out:out.exe input.vb

Voir aussi