-refout (Visual Basic)

  • Artikel

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.

Siehe auch