Übung: Erstellen und Ausführen Ihrer Anwendung

Abgeschlossen

Das .NET SDK (Software Development Kit) enthält eine Befehlszeilenschnittstelle (CLI), auf die über das integrierte Terminal von Visual Studio Code zugegriffen werden kann. Während dieses Trainings verwenden Sie .NET-CLI-Befehle, um neue Konsolenanwendungen zu erstellen, Ihren Projektcode zu kompilieren und Ihre Anwendungen auszuführen.

Mit dem folgenden .NET-CLI-Befehl wird beispielsweise eine neue Konsolenanwendung am angegebenen Ordnerspeicherort erstellt:

dotnet new console -o ./CsharpProjects/TestProject

Die Struktur eines CLI-Befehls besteht aus den folgenden drei Teilen:

  • Treiber: dotnet (in diesem Beispiel)
  • Befehl: new console (in diesem Beispiel)
  • Befehlsargumente: -o ./CsharpProjects/TestProject (in diesem Beispiel)

Hinweis

Befehlsargumente sind optionale Parameter, die verwendet werden können, um zusätzliche Informationen bereitzustellen. Der vorherige Befehl konnte ausgeführt werden, ohne den optionalen Ordnerspeicherort anzugeben. Beispiel: dotnet new console. In diesem Fall wird die neue Konsolenanwendung am aktuellen Ordnerspeicherort erstellt.

In dieser Übung verwenden Sie Visual Studio Code, um einen neuen Projektordner zu erstellen, eine neue Konsolenanwendung mithilfe eines CLI-Befehls zu erstellen, die Anwendung im Visual Studio Code-Editor anzupassen und dann Ihre App zu erstellen und auszuführen.

Erstellen einer C#-Konsolenanwendung in einem angegebenen Ordner

Zu Beginn erstellen Sie eine Konsolenanwendung an einem Ordnerspeicherort, der leicht zu finden und wiederzuverwenden ist.

  1. Stellen Sie sicher, dass Visual Studio Code geöffnet ist.

    Sie können das Windows-Startmenü verwenden, um Visual Studio Code zu suchen und zu öffnen.

  2. Klicken Sie im Visual Studio Code-Menü Datei auf Ordner öffnen.

    Das Dialogfeld „Ordner öffnen“ angezeigt. Sie können das Dialogfeld „Ordner öffnen“ verwenden, um einen neuen Ordner für Ihr C#-Projekt zu erstellen.

    Hinweis

    Wenn Sie Ihren eigenen PC verwenden und über einen Ordnerspeicherort verfügen, den Sie für Ihre Programmierprojekte verwenden, können Sie das Dialogfeld „Ordner öffnen“ verwenden, um zu einem gewünschten Ordnerspeicherort zu navigieren.

  3. Navigieren Sie im Dialogfeld Ordner öffnen zum Windows-Ordner „Desktop“.

    Wenn Sie Codeprojekte in der Regel in einem anderen Ordner speichern, können Sie stattdessen auch diesen verwenden. Für dieses Training ist es wichtig, einen Ort zu haben, den Sie leicht finden und sich gut merken können.

  4. Klicken Sie im Dialogfeld Ordner öffnen auf Ordner auswählen.

    Wenn ein Sicherheitsdialogfeld angezeigt wird, in dem Sie gefragt werden, ob Sie den Autor*innen vertrauen, wählen Sie Ja aus.

  5. Klicken Sie im Visual Studio Code-Menü Terminal die Option Neues Terminal aus.

    Screenshot: Eingabeaufforderung im Visual Studio Code-Panel „TERMINAL“

    Beachten Sie, dass eine Eingabeaufforderung im Panel „Terminal“ den Ordnerpfad für den aktuellen Ordner anzeigt. Beispiel:

    C:\Users\someuser\Desktop>
    
  6. Geben Sie an der Terminal-Eingabeaufforderung den folgenden Befehl ein, um eine neue Konsolenanwendung in einem angegebenen Ordner zu erstellen:

    dotnet new console -o ./CsharpProjects/TestProject
    

    Screenshot: Befehl, der im Visual Studio Code-Panel „TERMINAL“ eingegeben wird

    Dieser .NET-CLI-Befehl verwendet eine .NET-Programmvorlage, um ein neues C#-Konsolenanwendungsprojekt am angegebenen Ordnerspeicherort zu erstellen. Der Befehl erstellt die Ordner „CsharpProjects“ und „TestProject“ für Sie und verwendet „TestProject“ als Namen für Ihre .csproj-Datei.

  7. Erweitern Sie in der EXPLORER-Ansicht den Ordner "CsharpProjects ".

    Nun sollten der Ordner TestProject und zwei Dateien (eine C#-Programmdatei namens Program.cs und eine C#-Projektdatei namens TestProject.csproj) angezeigt werden. Der CLI-Befehl verwendet den Ordnernamen beim Erstellen der Projektdatei (TestProject.csproj). Die Datei „Program.cs“ ist die Datei, die Ihren C#-Code enthält.

  8. Wählen Sie in der EXPLORER-Ansicht zum Anzeigen des C#-Codes im Editorbereich Program.cs aus.

    Wie Sie sehen, ist "Hello, World!" die Standardkonsolenanwendung. Anwendung.

    // See https://aka.ms/new-console-template for more information
    Console.WriteLine("Hello, World!");
    

    Diese App verwendet die Console.WriteLine()-Methode, um "Hello, World!" im Konsolenfenster anzuzeigen.

Aktualisieren, Erstellen und Ausführen Ihrer Anwendung

In dieser Aufgabe verwenden Sie die EXPLORER-Ansicht, um Ihren Codeprojektordner zu öffnen, Ihre „Hallo“-Nachricht anzupassen und dann Ihre Anwendung auszuführen.

  1. Klicken Sie in der EXPLORER-Ansicht in Visual Studio Code mit der rechten Maustaste auf den Ordner TestProject, und wählen Sie dann In integriertem Terminal öffnen aus.

    Screenshot: Befehl, der im Visual Studio Code-Panel „Integriertes Terminal“ eingegeben wird

    Wichtig

    Die Eingabeaufforderung im Panel „Integriertes Terminal“ zeigt den Ordnerspeicherort an, an dem der Befehl ausgeführt wird. Bevor Sie einen build- oder run-Befehl ausführen, müssen Sie sicherstellen, dass das Terminal für Ihren Projektordner geöffnet ist.

  2. Überprüfen Sie, ob die Eingabeaufforderung im Terminalbereich den folgenden Ordnerpfad anzeigt:

    C:\Users\someuser\Desktop\CsharpProjects\TestProject>
    
  3. Aktualisieren Sie die Console.WriteLine()-Methode im Visual Studio Code-Editor wie folgt:

    Console.WriteLine("Hello C#!");
    

    Wenn Sie eine CS-Datei zum ersten Mal bearbeiten, werden Sie möglicherweise von Visual Studio Code aufgefordert, die fehlenden Ressourcen zum Erstellen und Debuggen Ihrer App hinzuzufügen. Wenn die Eingabeaufforderung angezeigt wird, können Sie Ja auswählen.

  4. Klicken Sie im Menü Datei auf Speichern.

    Sie müssen Ihre Codeänderungen immer in der Datei speichern. Codeänderungen, die Sie im Editor vorgenommen haben, werden vom Codecompiler erst erkannt, wenn der Code gespeichert ist.

  5. Um einen Build Ihrer Anwendung zu kompilieren, geben Sie an der Terminal-Eingabeaufforderung den folgenden Befehl ein:

    dotnet build
    

    Screenshot: Befehl „dotnet build“, der im Visual Studio Code-Panel „TERMINAL“ eingegeben wird

    Der dotnet build-Befehl erstellt das Projekt und die zugehörigen Abhängigkeiten in einen Satz von Binärdateien. Die Binärdateien enthalten den Projektcode in IL-Dateien (Intermediate Language) mit der Erweiterung DLL. Abhängig vom Projekttyp und den Einstellungen können auch andere Dateien enthalten sein. Wenn Sie neugierig sind, finden Sie die TestProject.dll Datei in der EXPLORER-Ansicht an einem Ordnerspeicherort, der dem folgenden Pfad ähnelt:

    C:\Users\someuser\Desktop\CsharpProjects\TestProject\bin\Debug\net7.0\

    Hinweis

    Ihr Ordnerpfad spiegelt Ihr Konto und den Ordnerpfad zu Ihrem TestProject-Ordner wider.

  6. Um Ihre Anwendung auszuführen, geben Sie an der TERMINAL-Eingabeaufforderung den folgenden Befehl ein:

    dotnet run
    

    Der dotnet run-Befehl führt Quellcode ohne explizite Kompilier- oder Startbefehle aus. Er bietet eine praktische Option zum Ausführen der Anwendung über den Quellcode mit einem Befehl. Es empfiehlt sich für eine schnelle iterative Entwicklung aus der Befehlszeile. Der Befehl hängt vom Befehl „dotnet build“ ab, um den Code kompilieren zu können.

  7. Beachten Sie, dass Hello C# im Panel „TERMINAL“ in der Zeile unter dem dotnet run-Befehl angezeigt wird.

    Wenn Sie „Hallo, Welt!“ sehen, stellen Sie sicher, dass Sie Ihre Codeänderungen gespeichert haben.

Glückwunsch, Sie haben die Einrichtung von Visual Studio Code und das Erstellen und Ausführen einer einfachen Codezeile abgeschlossen.