/reference
Aktualisiert: November 2007
Importiert Metadaten.
/reference:file[;file2]
Argumente
- file, file2
Eine oder mehrere Dateien mit Assemblymanifest. Wenn mehrere Dateien importiert werden sollen, trennen Sie die Dateinamen durch ein Komma oder Semikolon voneinander.
Hinweise
Die /reference-Option weist den Compiler an, dem derzeitig kompilierten Projekt öffentliche Typinformationen in den angegebenen Dateien bereitzustellen.
Bei den Dateien, auf die verwiesen wird, muss es sich um Assemblys handeln. Die Dateien, auf die verwiesen wird, müssen z. B. mit der Compileroption /target:libraryin Visual C#, JScript oder Visual Basic bzw. den Compileroptionen /clr/LDin Visual C++ erstellt worden sein.
Für /reference ist kein Modul als Eingabe zulässig.
Wenn auf eine Assembly verwiesen wird (Assembly A), die ihrerseits auf eine weitere Assembly verweist (Assembly B), müssen Sie in folgenden Fällen auf Assembly B verweisen:
Ein für Assembly A verwendeter Typ erbt von einem Typ oder implementiert eine Schnittstelle aus Assembly B.
Ein Feld, eine Eigenschaft, ein Ereignis oder eine Methode mit einem Rückgabe- oder Parametertyp aus Assembly B wird aufgerufen.
Verwenden Sie /lib, um das Verzeichnis anzugeben, in dem sich ein oder mehrere Assemblyverweise befinden.
Damit der Compiler einen Typ in einer Assembly (nicht in einem Modul) erkennen kann, muss die Auflösung des Typs erzwungen werden. Dies wird z. B. durch die Definition einer Instanz des betreffenden Typs erreicht. Der Compiler verfügt über andere Möglichkeiten, um die Typnamen in einer Assembly aufzulösen. Beispielsweise wird dem Compiler beim Erben von einem Typ in einer Assembly der Typname mitgeteilt.
/r ist die Kurzform von /reference.
.gif "Hinweis") Hinweis: |
|---|
Der JScript-Compiler jsc.exe kann auf Assemblys verweisen, die mit derselben Version oder einer früheren Version des Compilers erstellt wurden. Möglicherweise stößt der JScript-Compiler auf Kompilierzeitfehler, wenn auf Assemblys verwiesen wird, die mit neueren Versionen des Compilers erstellt wurden. So kann der JScript .NET 2003-Compiler auf beliebige Assemblys verweisen, die mit dem JScript .NET 2002-Compiler erstellt wurden, wohingegen der JScript .NET 2002-Compiler möglicherweise fehlschlägt, wenn der Verweis auf eine Assembly erfolgt, die mit JScript .NET 2003 erstellt wurde. |
Beispiel
In diesem Beispiel wird die Quelldatei input.js kompiliert, und Metadaten werden aus metad1.dll und metad2.dll für die Erstellung von out.exe importiert:
jsc /reference:metad1.dll;metad2.dll /out:out.exe input.js