/reference
Consente l'importazione di metadati.
/reference:file[;file2]
Argomenti
- file, file2
Rappresenta uno o più file contenenti un manifesto assembly. Per importare più file, separare i nomi dei file con una virgola o un punto e virgola.
Note
L'opzione /reference fa sì che il compilatore renda disponibili al progetto in corso di compilazione le informazioni sui tipi pubblici presenti nei file specificati.
I file cui viene fatto riferimento devono essere assembly. I file a cui viene fatto riferimento devono ad esempio essere stati creati con l'opzione /target:library del compilatore in Visual C#, JScript o Visual Basic oppure con le opzioni /clr /LD del compilatore in Visual C++.
Per /reference non è possibile assegnare un modulo come input.
Se si fa riferimento a un assembly (assembly A) che fa a sua volta riferimento a un secondo assembly (assembly B), sarà necessario fare riferimento all'assembly B nei seguenti casi:
Se un tipo dell'assembly A eredita da un tipo o implementa un'interfaccia dell'assembly B.
Se si richiama un campo, una proprietà, un evento o un metodo che presenta un tipo restituito o un tipo di parametro proveniente dall'assembly B.
Per specificare la directory in cui si trova uno o più assembly cui si fa riferimento, utilizzare /lib.
Perché il compilatore sia in grado di riconoscere un tipo in un assembly (non in un modulo), è necessario imporre la risoluzione del tipo stesso. A tale scopo, è possibile definire un'istanza del tipo. La risoluzione dei nomi dei tipi in un assembly da parte del compilatore può avvenire anche con altre modalità. Se, ad esempio, si eredita da un tipo in un assembly, il nome del tipo risulterà noto al compilatore.
/r rappresenta la forma abbreviata di /reference.
Nota
Il compilatore JScript: jsc.exe, può fare riferimento ad assembly creati utilizzando la stessa versione o una versione precedente del compilatore. Quando si fa riferimento ad assembly creati con versioni successive del compilatore JScript, potrebbero verificarsi errori in fase di compilazione. Il compilatore JScript .NET 2003, ad esempio, può fare riferimento a qualsiasi assembly creato con il compilatore JScript .NET 2002, mentre quest'ultimo potrebbe non funzionare correttamente quando fa riferimento a un assembly creato con JScript .NET 2003.
Esempio
Compilare il file di origine input.js e importare metadati da metad1.dll e metad2.dll per creare out.exe:
jsc /reference:metad1.dll;metad2.dll /out:out.exe input.js