-refout (Visual Basic)
Die Option -refout gibt einen Dateipfad an, an den die Verweisassembly ausgegeben werden soll.
Jede Compileroption ist in zwei Varianten verfügbar: -option
und /option
. In der Dokumentation wird nur die Form „-option
“ gezeigt.
Syntax
-refout:filepath
Argumente
filepath
Der Pfad und der Dateiname der Verweisassembly. Diese sollte sich im Allgemeinen in einem Unterordner der primären Assembly befinden. Die empfohlene Konvention (von MSBuild verwendet) ist die, die Verweisassembly in einem „ref/“-Unterordner zu platzieren, der relativ zur primären Assembly ist. Alle Ordner in filepath
müssen vorhanden sein. Sie werden nicht vom Compiler erstellt.
Hinweise
Visual Basic unterstützt den -refout
-Switch ab Version 15.3.
Verweisassemblys sind eine besondere Art von Assembly, die nur die Mindestmenge an Metadaten enthalten, die zum Darstellen der öffentlichen API-Oberfläche der Bibliothek erforderlich sind. Sie beinhalten Deklarationen für alle Member, die beim Verweis auf eine Assembly in Buildtools von Bedeutung sind, schließen aber alle Memberimplementierungen und Deklarationen privater Member aus, die keine beobachtbaren Auswirkungen auf ihren API-Vertrag haben. Weitere Informationen finden Sie unter Verweisassemblys im .NET-Leitfaden.
Die Optionen -refout
und -refonly
schließen sich gegenseitig aus.