Freigeben über

Übersicht über die .NET CLI

  • Artikel

Dieser Artikel gilt für: ✔️ .NET Core 3.1 SDK und höher

Die .NET-Befehlszeilenschnittstelle (CLI) ist eine plattformübergreifende Toolkette zum Entwicklung, Erstellen, Ausführen und Veröffentlichen von .NET-Anwendungen.

Die .NET CLI ist im .NET SDK enthalten. Weitere Informationen zum Installieren des .NET SDK finden Sie unter Installieren von .NET. Nach der Installation des SDK können Sie CLI-Befehle ausführen, indem Sie ein Terminal öffnen und die Befehle an der Terminalaufforderung eingeben.

Befehlsstruktur

Cli-Befehlsstruktur besteht aus dem Treiber ("dotnet"), dem Befehl und möglicherweise Befehlsargumenten und -optionen. Dieses Muster wird in den meisten CLI-Vorgängen angezeigt, z. B. beim Erstellen einer neuen Konsolen-App und beim Ausführen über die Befehlszeile. Die folgenden Befehle zeigen, wann die Konsolen-App aus einem Verzeichnis mit dem Namen my_app ausgeführt wurde:

dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll

Fahrer

Der Treiber heißt dotnet und hat zwei Zuständigkeiten, entweder das Ausführen einer frameworkabhängigen App oder das Ausführen eines Befehls.

Um eine frameworkabhängige App auszuführen, geben Sie den Pfad zur .dll Datei der App nach dem Treiber an, dotnet /path/to/my_app.dllohne beispielsweise einen Befehl anzugeben. Wenn Sie den Befehl aus dem Ordner ausführen, in dem sich die DLL-Datei der App befindet, führen Sie einfach aus dotnet my_app.dll. Weitere Informationen finden Sie im Dotnet-Befehl.

Wenn Sie dem Treiber einen Befehl bereitstellen, dotnet.exe beginnt der Prozess zur Ausführung des CLI-Befehls. Beispiel:

dotnet build

Zuerst bestimmt der Treiber die zu verwendende Version des SDK. Wenn keine global.json Datei vorhanden ist, wird die neueste Version des verfügbaren SDK verwendet. Nachdem die SDK-Version bestimmt wurde, wird der Befehl ausgeführt.

Befehl

Der Befehl führt eine Aktion aus. Zum Beispiel kompiliert dotnet build Code. dotnet publish veröffentlicht Code. Eine Liste der Befehle finden Sie im Abschnitt "CLI-Befehle ".

Argumente

Die Argumente, die Sie an die Befehlszeile übergeben, sind die Argumente für den aufgerufenen Befehl oder optionen, die mit dem Befehl angegeben werden. Wenn Sie beispielsweise ausführen dotnet publish my_app.csproj, gibt das Argument das my_app.csproj zu veröffentlichende Projekt an und wird an den publish Befehl übergeben.

Optionen

Die Optionen, die Sie an die Befehlszeile übergeben, sind die Optionen für den aufgerufenen Befehl. Wenn Sie beispielsweise dotnet publish --output /build_output ausführen, wird die vom Argument /build_output bereitgestellte Option --output und ihr Wert an den publish Befehl übergeben.

CLI-Befehle

Die folgenden Befehle werden standardmäßig installiert:

Grundlegende Befehle

Projektänderungsbefehle

NuGet-Befehle

Workloadverwaltungsbefehle

Erweiterte Befehle

Toolverwaltungsbefehle

Tools sind Konsolenanwendungen, die aus NuGet-Paketen installiert sind und über die Eingabeaufforderung aufgerufen werden. Sie können Tools selbst schreiben oder Tools installieren, die von Dritten geschrieben wurden. Tools werden auch als globale Tools, Toolpfadtools und lokale Tools bezeichnet. Weitere Informationen finden Sie unter Überblick über .NET-Tools.

Siehe auch