-reference (Visual Basic)

  • Artikel

Hiermit wird bewirkt, dass der Compiler Typinformationen in den angegebenen Assemblys des Projekts zur Verfügung stellt, das Sie aktuell kompilieren.

Syntax

-reference:fileList

oder

-r:fileList

Argumente

Begriff Definition
fileList Erforderlich. Durch Trennzeichen getrennte Liste von Assemblydateinamen. Wenn der Dateiname ein Leerzeichen enthält, müssen Sie den Namen in Anführungszeichen einschließen.

Hinweise

Die Dateien, die Sie importieren, müssen Assemblymetadaten enthalten. Nur öffentliche Typen sind außerhalb der Assembly sichtbar. Mit der Option -addmodule werden Metadaten aus einem Modul importiert.

Wenn Sie auf eine Assembly (Assembly A) verweisen, die selbst auf eine andere Assembly (Assembly B) verweist, müssen Sie auf Assembly B verweisen, wenn:

  • Ein Typ von Assembly A erbt von einem Typ oder implementiert eine Schnittstelle aus Assembly B.

  • Es wird ein Feld, eine Eigenschaft, ein Ereignis oder eine Methode aufgerufen, das/die über einen Rückgabetyp oder Parametertyp von Assembly B verfügt.

Verwenden Sie -libpath, um das Verzeichnis anzugeben, in dem sich einer oder mehrere der Assemblyverweise befinden.

Damit der Compiler einen Typ in einer Assembly (nicht in einem Modul) erkennen kann, muss er gezwungen werden, den Typ aufzulösen. Ein Beispiel hierfür ist das Definieren einer Instanz des Typs. Es stehen andere Möglichkeiten zum Auflösen von Typnamen in einer Assembly für den Compiler zur Verfügung. Wenn z. B. von einem Typ in einer Assembly geerbt wird, wird dem Compiler der Typname mitgeteilt.

Die Vbc.rsp-Antwortdatei, die auf häufig verwendete .NET Framework-Assemblys verweist, wird standardmäßig verwendet. Verwenden Sie -noconfig, wenn der Compiler „Vbc.rsp“ nicht verwenden soll.

Die Kurzform von -reference ist -r.

Beispiel

Mit dem folgenden Befehl werden die Quelldatei Input.vb und Verweisassemblys aus Metad1.dll und Metad2.dll kompiliert, um Out.exe zu erstellen.

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

Siehe auch