Övning – Skapa, skapa och köra ditt program

Slutförd

.NET Software Development Kit (SDK) innehåller ett kommandoradsgränssnitt (CLI) som kan nås från Visual Studio Codes integrerade terminal. Under den här utbildningen använder du .NET CLI-kommandon för att skapa nya konsolprogram, skapa din projektkod och köra dina program.

Följande .NET CLI-kommando skapar till exempel ett nytt konsolprogram på den angivna mappplatsen:

dotnet new console -o ./CsharpProjects/TestProject

Strukturen för ett CLI-kommando består av följande tre delar:

  • Drivrutinen: dotnet i det här exemplet.
  • Kommandot: new console i det här exemplet.
  • Kommandoargumenten: -o ./CsharpProjects/TestProject i det här exemplet.

Kommentar

Kommandoargument är valfria parametrar som kan användas för att ange ytterligare information. Det tidigare kommandot kan köras utan att ange den valfria mappplatsen. Exempel: dotnet new console. I det här fallet skapas det nya konsolprogrammet på den aktuella mappplatsen.

I den här övningen använder du Visual Studio Code för att skapa en ny projektmapp, skapa ett nytt konsolprogram med ett CLI-kommando, anpassa programmet i Visual Studio Code-redigeraren och sedan skapa och köra appen.

Skapa ett C#-konsolprogram i en angiven mapp

Börja med att skapa ett konsolprogram på en mappplats som är enkel att hitta och återanvända.

  1. Kontrollera att Visual Studio Code är öppet.

    Du kan använda Windows Start-menyn för att hitta och öppna Visual Studio Code.

  2. På menyn Visual Studio Code-fil väljer du Öppna mapp.

    Dialogrutan Öppna mapp visas. Du kan använda dialogrutan Öppna mapp för att skapa en ny mapp för ditt C#-projekt.

    Kommentar

    Om du arbetar på din personliga dator och du har en mappplats som du använder för dina kodningsprojekt kan du använda dialogrutan Öppna mapp för att navigera till en önskad mappplats.

  3. I dialogrutan Öppna mapp navigerar du till mappen Windows Desktop.

    Om du har en annan mappplats där du behåller kodprojekt kan du använda den mappplatsen i stället. För den här utbildningen är det viktigt att ha en plats som är lätt att hitta och komma ihåg.

  4. I dialogrutan Öppna mapp väljer du Välj mapp.

    Om du ser en säkerhetsdialogruta som frågar om du litar på författarna väljer du Ja.

  5. Välj Ny terminal på visual Studio Code-terminalmenyn.

    Skärmbild som visar kommandotolken i terminalpanelen i Visual Studio Code.

    Observera att en kommandotolk i terminalpanelen visar mappsökvägen för den aktuella mappen. Till exempel:

    C:\Users\someuser\Desktop>
    
  6. I kommandotolken i Terminal anger du följande kommando för att skapa ett nytt konsolprogram i en angiven mapp:

    dotnet new console -o ./CsharpProjects/TestProject
    

    Skärmbild som visar ett kommando som anges i terminalpanelen i Visual Studio Code.

    Det här .NET CLI-kommandot använder en .NET-programmall för att skapa ett nytt C#-konsolprogramprojekt på den angivna mappplatsen. Kommandot skapar mapparna CsharpProjects och TestProject åt dig och använder TestProject som namnet på filen .csproj .

  7. I utforskarvyn expanderar du mappen CsharpProjects .

    Du bör se mappen TestProject och två filer, en C#-programfil med namnet Program.cs och en C#-projektfil med namnet TestProject.csproj. CLI-kommandot använder mappnamnet när den skapar projektfilen (TestProject.csproj). Filen Program.cs är filen som innehåller C#-koden.

  8. I utforskarvyn väljer du Program.cs om du vill visa C#-koden i redigeringspanelen.

    Som du ser är standardkonsolprogrammet det ikoniska "Hello World!" tillämpning.

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

    Den här appen använder Console.WriteLine() metoden för att visa "Hello, World!" i konsolfönstret.

Uppdatera, skapa och köra ditt program

I den här uppgiften använder du EXPLORER-vyn för att öppna kodprojektmappen, anpassa meddelandet "Hello" och sedan köra programmet.

  1. I vyn Visual Studio Code EXPLORER högerklickar du på mappen TestProject och väljer sedan Öppna i integrerad terminal.

    Skärmbild som visar ett kommando som anges i den integrerade terminalpanelen i Visual Studio Code.

    Viktigt!

    Kommandotolken i den integrerade terminalpanelen visar den mappplats där kommandot ska köras. Innan du kör ett kommando eller build ett run kommando måste du se till att terminalen är öppen för projektmappen.

  2. Kontrollera att kommandotolken i terminalpanelen visar följande mappsökväg:

    C:\Users\someuser\Desktop\CsharpProjects\TestProject>
    
  3. Uppdatera metoden på följande sätt i Console.WriteLine() Visual Studio Code-redigeraren:

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

    Första gången du redigerar en .cs fil kan Visual Studio Code uppmana dig att lägga till de saknade tillgångarna för att skapa och felsöka din app. Om du ser uppmaningen kan du välja Ja.

  4. Arkiv-menyn väljer du Spara.

    Du måste alltid spara kodändringarna i filen. Kodändringar som du har gjort i redigeraren identifieras inte av kodkompilatorn förrän koden har sparats.

  5. Om du vill kompilera en version av ditt program anger du följande kommando i kommandotolken i Terminal:

    dotnet build
    

    Skärmbild som visar kommandot dotnet build som angetts i terminalpanelen i Visual Studio Code.

    Kommandot dotnet build skapar projektet och dess beroenden i en uppsättning binärfiler. Binärfilerna innehåller projektets kod i IL-filer (Intermediate Language) med ett .dll-tillägg. Beroende på projekttyp och inställningar kan även andra filer inkluderas. Om du är nyfiken kan du hitta den TestProject.dll filen i EXPLORER-vyn på en mappplats som liknar följande sökväg:

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

    Kommentar

    Mappsökvägen återspeglar ditt konto och mappsökvägen till mappen TestProject.

  6. Om du vill köra programmet anger du följande kommando i kommandotolken i Terminal:

    dotnet run
    

    Kommandot dotnet run kör källkoden utan några explicita kompilerings- eller startkommandon. Det är ett praktiskt alternativ för att köra ditt program från källkoden med ett kommando. Det är användbart för snabb iterativ utveckling från kommandoraden. Kommandot är beroende av dotnet build-kommandot för att skapa koden.

  7. Observera att Hello C# visas i terminalpanelen på raden under dotnet run kommandot .

    Om du ser "Hello, World!" visas kontrollerar du att du har sparat kodändringarna.

Grattis, du har slutfört konfigurationen av Visual Studio Code och skapat och kört en enkel kodrad!