/reference
Importe des métadonnées.
/reference:file[;file2]
Arguments
- file, file2
Chacun des fichiers contenant un manifeste d'assembly. Pour importer plusieurs fichiers, séparez les noms de fichiers par une virgule ou un point-virgule.
Notes
Avec l'option /reference, le compilateur permet au projet que vous compilez d'accéder aux informations des types publics contenues dans les fichiers spécifiés.
Les fichiers référencés doivent être des assemblys. Par exemple, ils doivent avoir été créés avec l'option de compilateur /target:library dans Visual C#, JScript ou Visual Basic, ou avec les options de compilateur /clr /LD dans Visual C++.
Vous ne pouvez pas spécifier un nom de module avec l'option /reference.
Si vous référencez un assembly (assembly A) qui lui-même référence un autre assembly (assembly B), vous devez aussi référencer l'assembly B dans les cas suivants :
Un type que vous utilisez à partir de l'Assembly A hérite d'un type ou implémente une interface à partir de l'Assembly B.
Vous appelez un champ, une propriété, un événement ou une méthode qui possède un type de retour ou un type de paramètre de l'assembly B.
Utilisez l'option /lib pour spécifier le répertoire dans lequel se trouvent une ou plusieurs de vos références d'assembly.
Pour qu'un compilateur reconnaisse un type dans un assembly (pas un module), il doit résoudre le type. Pour ce faire, vous pouvez par exemple définir une instance du type. Le compilateur peut résoudre les noms de types d'un assembly de plusieurs autres façons : par exemple, lorsqu'un type est hérité d'un autre type d'un assembly, le nom du type est alors connu du compilateur.
/r est la forme abrégée de /reference.
Notes
Le compilateur JScript, jsc.exe, peut référencer les assemblys créés à l'aide d'une version antérieure ou identique du compilateur. Toutefois, le compilateur JScript peut générer des erreurs de compilation en référençant des assemblys créés à l'aide d'une version ultérieure du compilateur. Par exemple, le compilateur JScript .NET 2003 peut référencer tout assembly créé à l'aide du compilateur JScript .NET 2002, tandis que le compilateur JScript .NET 2002 peut ne pas réussir à référencer un assembly créé à l'aide de JScript .NET 2003.
Exemple
Compilez le fichier source input.js et importez les métadonnées des fichiers metad1.dll et metad2.dll afin d'obtenir le fichier out.exe :
jsc /reference:metad1.dll;metad2.dll /out:out.exe input.js