Dela via


Självstudie: Kom igång med C# och ASP.NET Core i Visual Studio

I den här självstudien för C#-utveckling med ASP.NET Core skapar du en C# ASP.NET Core-webbapp i Visual Studio.

Den här handledningen visar hur du:

  • Skapa ett Visual Studio-projekt
  • Skapa en C# ASP.NET Core-webbapp
  • Göra ändringar i webbappen
  • Utforska IDE-funktioner
  • Kör webbappen

Förutsättningar

För att slutföra den här självstudien behöver du:

Skapa ett projekt

Först skapar du ett ASP.NET Core-projekt. Projekttypen levereras med alla mallfiler som du behöver för att skapa en fullt fungerande webbplats.

  1. I startfönstret väljer du Skapa ett nytt projekt.

    Skärmbild som visar startfönstret för Visual Studio. Skapa ett nytt projektalternativ är markerat.

  2. I fönstret Skapa ett nytt projekt väljer du C# i listan Språk. Välj sedan Windows i plattformslistan och Web från listan med projekttyper.

    När du har tillämpat filter för språk, plattform och projekttyp väljer du mallen ASP.NET Core Web App och väljer sedan Nästa.

    Skärmbild som visar ASP.NET Core Web App-projektmallen markerad i dialogrutan Nytt projekt i Visual Studio.

  3. I fönstret Konfigurera ditt nya projekt anger du MyCoreApp i fältet Project name . Välj sedan Nästa.

    Skärmbild som visar fönstret Konfigurera ditt nya projekt i Visual Studio med MyCoreApp angivet i fältet Projektnamn.

  4. I fönstret Ytterligare information kontrollerar du att .NET Core 3.1 visas i fältet Target Framework.

    Från det här fönstret kan du aktivera Docker-stöd och lägga till autentiseringsstöd. Den nedrullningsbara menyn för autentiseringstyp har följande fyra alternativ:

    • Ingen: Ingen autentisering.
    • Enskilda konton: Dessa autentiseringar lagras i en lokal eller Azure-baserad databas.
    • Microsoft identity platform: Det här alternativet använder Microsoft Entra-ID eller Microsoft 365 för autentisering.
    • Windows: Lämplig för intranätprogram.

    Låt kryssrutan Aktivera Docker vara avmarkerad och välj Ingen för autentiseringstyp.

    Skärmbild som visar standardinställningarna i fönstret Ytterligare information där målramverket är inställt på .NET Core 3.1.

  5. Välj Skapa.

Visual Studio öppnar det nya projektet.

  1. I startfönstret väljer du Skapa ett nytt projekt.

    Skärmbild som visar startfönstret för Visual Studio. Skapa ett nytt projektalternativ är markerat.

  2. I fönstret Skapa ett nytt projekt väljer du C# i listan Språk. Välj sedan Windows i listan Alla plattformar och Web från listan Alla projekttyper.

    När du har tillämpat filter för språk, plattform och projekttyp väljer du mallen ASP.NET Core Web App (Razor Pages) och väljer sedan Nästa.

    Skärmbild som visar ASP.NET Core Web App-projektmallen vald och markerad på sidan Skapa ett nytt projekt.

  3. I fönstret Konfigurera ditt nya projekt anger du MyCoreApp i fältet Project name . Välj sedan Nästa.

    Skärmbild som visar fönstret Konfigurera det nya projektet i Visual Studio med MyCoreApp angivet i fältet Projektnamn.

  4. I fönstret Ytterligare information kontrollerar du att .NET 8.0 visas i fältet Target Framework.

    Från det här fönstret kan du aktivera containerstöd och lägga till autentiseringsstöd. Den nedrullningsbara menyn för autentiseringstyp har följande fyra alternativ:

    • Ingen: Ingen autentisering.
    • Enskilda konton: Dessa autentiseringar lagras i en lokal eller Azure-baserad databas.
    • Microsoft identity platform: Det här alternativet använder Microsoft Entra-ID eller Microsoft 365 för autentisering.
    • Windows: Lämplig för intranätprogram.

    Låt rutan Aktivera containerstöd vara avmarkerad och välj Ingen för autentiseringstyp.

    Skärmbild som visar standardinställningarna i fönstret Ytterligare information där målramverket är inställt på .NET 8.0.

  5. Välj Skapa.

Visual Studio öppnar det nya projektet.

Om din lösning

Den här lösningen följer designmönstret Razor Page. Det skiljer sig från Modell–View-Controller (MVC) designmönstret eftersom modellen och styrenhetskoden är integrerade i själva Razor-sidan.

Gå igenom din lösning

  1. Projektmallen skapar en lösning med ett enda ASP.NET Core-projekt med namnet MyCoreApp. Välj fliken Solution Explorer för att visa innehållet.

    Skärmbild som visar det MyCoreApp-projekt som valts i Solution Explorer i Visual Studio.

  2. Expandera mappen Pages.

    Skärmbild som visar innehållet i mappen Pages i Solution Explorer i Visual Studio.

  3. Välj filen Index.cshtml och visa filen i kodredigeraren.

    Skärmbild som visar filen Indexpunkt c s h t m l öppen i Visual Studio-kodredigeraren.

  4. Varje .cshtml-fil har en associerad kodfil. Om du vill öppna kodfilen i redigeraren expanderar du noden Index.cshtml i Solution Explorer och väljer filen Index.cshtml.cs.

    Skärmbild som visar Index.html-filen vald i Solution Explorer i Visual Studio.

  5. Visa filen Index.cshtml.cs i kodredigeraren.

    Skärmbild som visar filen Index dot c s h t m l dot c s öppen i Visual Studio-kodredigeraren.

  6. Projektet innehåller en wwwroot- mapp, som är roten för din webbplats. Expandera mappen för att visa dess innehåll.

    Skärmbild som visar den w w w rotmapp som valts i Solution Explorer i Visual Studio.

    Du kan placera statiskt webbplatsinnehåll som CSS, bilder och JavaScript-bibliotek direkt i sökvägarna där du vill ha dem.

    Projektet innehåller även konfigurationsfiler som hanterar webbappen under drift. Standardprogrammet konfiguration lagras i appsettings.json. Du kan dock åsidosätta de här inställningarna med hjälp av appsettings.Development.json.

  7. Expandera filen appsettings.json för att visa filen appsettings.Development.json.

    Skärmbild som visar appsettings.json vald och expanderad i Solution Explorer i Visual Studio.

Köra, felsöka och göra ändringar

  1. I verktygsfältet väljer du knappen IIS Express för att skapa och köra appen i felsökningsläge. Du kan också trycka på F5eller gå till Felsök>Starta felsökning från menyraden.

    Skärmbild som visar I S Express-knappen markerad i verktygsfältet i Visual Studio.

    Notera

    Om du får ett felmeddelande om Det går inte att ansluta till webbservern "IIS Express"stänger du Visual Studio och startar sedan om programmet som administratör. Du kan utföra den här uppgiften genom att högerklicka på Visual Studio-ikonen på Start-menyn och sedan välja alternativet Kör som administratör på snabbmenyn.

    Du kan också få ett meddelande som frågar om du vill acceptera ett IIS SSL Express-certifikat. Om du vill visa koden i en webbläsare väljer du Jaoch väljer sedan Ja om du får ett varningsmeddelande om uppföljningssäkerhet.

  2. Visual Studio startar ett webbläsarfönster. Du bör sedan se Hem och Sekretess sidor i menyraden.

  3. Välj Sekretess i menyraden. Sidan Sekretess i webbläsaren återger texten som anges i filen Privacy.cshtml.

    Skärmbild som visar sidan Sekretess för MyCoreApp med följande text: Använd den här sidan för att beskriva webbplatsens sekretesspolicy.

  4. Gå tillbaka till Visual Studio och tryck sedan på Skift+F5- för att sluta felsöka. Den här åtgärden stänger projektet i webbläsarfönstret.

  5. Öppna Privacy.cshtml för redigering i Visual Studio. Ta sedan bort meningen Använd den här sidan för att beskriva webbplatsens sekretesspolicy och ersätta den med Sidan är under uppbyggnad från och med @ViewData["TimeStamp"].

    Skärmbild som visar filen Privacy.cshtml öppen i Visual Studio Code-redigeraren med den uppdaterade texten.

  6. Nu ska vi göra en kodändring. Välj Privacy.cshtml.cs. Rensa sedan using-direktiven överst i filen med hjälp av följande genväg:

    Håll muspekaren över eller välj ett nedtonat using-direktiv. En Snabbåtgärder glödlampa visas under caret eller i vänstermarginalen. Välj glödlampan och välj sedan Ta bort onödiga användningar.

    Skärmbilden visar filen Privacy.cshtml i Visual Studio-kodredigeraren med snabbåtgärdsverktygstipset synligt för ett nedtonat using-direktiv.

    Välj nu Förhandsgranska ändringar för att se vilka ändringar.

    Skärmbild som visar dialogrutan Förhandsgranska ändringar. Dialogrutan visar direktivet som tas bort och förhandsgranskar kodändringen efter borttagningen.

    Välj Använd. Visual Studio tar bort onödiga using direktiv från filen.

  7. I metoden OnGet() ändrar du sedan brödtexten till följande kod:

    public void OnGet()
    {
       string dateTime = DateTime.Now.ToShortDateString();
       ViewData["TimeStamp"] = dateTime;
    }
    
  8. Observera att en vågig understrykning visas under DateTime-. Vågig understrykning visas eftersom den här typen inte är inom räckvidd.

    Skärmbild som visar ett felmärke i form av en vågig understrykning för DateTime i Visual Studio-kodredigeraren.

    Öppna verktygsfältet fellista om du vill se samma fel i listan. Om du inte ser verktygsfältet fellista går du till Visa>fellista från det översta menyfältet.

    Skärmdump som visar verktygsfältet Fellista i Visual Studio med DateTime i listan.

  9. Vi åtgärdar det här felet. I kodredigeraren placerar du markören på raden som innehåller felet och väljer sedan glödlampan Snabbåtgärder i vänstermarginalen. Välj sedan med hjälp av System i den nedrullningsbara menyn. Använd för att lägga till det här direktivet överst i din fil och åtgärda felen.

    Skärmbild som visar alternativen för snabbåtgärder från den nedrullningsbara menyn med muspekaren på med hjälp av System.

  10. Tryck på F5 för att öppna projektet i webbläsaren.

  11. Längst upp på webbplatsen väljer du Sekretess för att visa dina ändringar.

    Skärmbild som visar den uppdaterade sidan Sekretess som innehåller de ändringar du har gjort.

  12. Stäng webbläsaren, tryck på Skift+F5 för att sluta felsöka.

Ändra startsidan

  1. I Solution Explorerexpanderar du mappen Pages och väljer sedan Index.cshtml.

    Skärmbild som visar indexpunkt c s h t m l markerat under noden Sidor i Solution Explorer.

    Filen Index.cshtml motsvarar din startsida i webbappen, som körs i en webbläsare.

     Skärmbild som visar startsidan för webbappen i webbläsarfönstret.

    I kodredigeraren visas HTML-kod för texten som visas på sidan Start.

    Skärmbild som visar filen Index dot c s h t m l för startsidan i Visual Studio-kodredigeraren.

  2. Ersätt texten Välkommen med Hello World!

    Skärmbild som visar filen Index dot c s h t m l i Visual Studio-kodredigeraren med välkomsttexten ändrad till Hello World!.

  3. Välj IIS Express eller tryck på Ctrl+F5 för att köra appen och öppna den i en webbläsare.

    Skärmbild som visar knappen IIS Express markerad i verktygsfältet för Visual Studio.

  4. I webbläsarfönstret ser du dina nya ändringar på sidan Startsida.

    Skärmbild som visar startsidan för webbappen i webbläsarfönstret. Den uppdaterade texten säger Hello World!

  5. Stäng webbläsaren, tryck på Skift+F5 för att sluta felsöka och spara projektet. Nu kan du stänga Visual Studio.

Gå igenom din lösning

  1. Projektmallen skapar en lösning med ett enda ASP.NET Core-projekt med namnet MyCoreApp. Välj fliken Solution Explorer för att visa innehållet.

    Skärmbild som visar det valda MyCoreApp-projektet och dess innehåll i Solution Explorer i Visual Studio.

  2. Expandera mappen Pages.

    Skärmbild som visar innehållet i mappen Pages i Solution Explorer.

  3. Välj filen Index.cshtml och visa i kodredigeraren.

    Skärmbild som visar filen Index.cshtml öppen i Visual Studio Code-redigeraren.

  4. Varje .cshtml-fil har en associerad kodfil. Om du vill öppna kodfilen i redigeraren expanderar du noden Index.cshtml i Solution Explorer och väljer filen Index.cshtml.cs.

    Skärmbild som visar filen Index.cshtml markerad i Solution Explorer i Visual Studio.

  5. Visa filen Index.cshtml.cs i kodredigeraren.

    Skärmbild som visar filen Index.cshtml.cs öppen i Visual Studio Code-redigeraren.

  6. Projektet innehåller en wwwroot- mapp, som är roten för din webbplats. Expandera mappen för att visa dess innehåll.

    Skärmbild som visar w w w-rotmappen vald i Solution Explorer i Visual Studio.

    Du kan placera statiskt webbplatsinnehåll som CSS, bilder och JavaScript-bibliotek direkt i sökvägarna där du vill ha dem.

  7. Projektet innehåller även konfigurationsfiler som hanterar webbapplikationen under körning. Standardprogrammet konfiguration lagras i appsettings.json. Du kan dock åsidosätta de här inställningarna med hjälp av appsettings.Development.json. Expandera filen appsettings.json för att visa filen appsettings.Development.json.

    Skärmbild som visar appsettings.json markerat och expanderat, vilket visar appsettings.Development.jsoni Solution Explorer i Visual Studio.

Köra, felsöka och göra ändringar

  1. I verktygsfältet väljer du knappen https för att skapa och köra appen i felsökningsläge. Du kan också trycka på F5eller gå till Felsök>Starta felsökning från menyraden.

    Skärmbild som visar https-knappen markerad i verktygsfältet i Visual Studio.

    Not

    Du kan också få ett meddelande som frågar om du vill godkänna ett ASP.NET Core SSL-certifikat. Om du vill visa koden i en webbläsare väljer du Jaoch väljer sedan Ja om du får ett varningsmeddelande om uppföljningssäkerhet. Läs mer om tvinga fram SSL i ASP.NET Core.

  2. Visual Studio startar ett webbläsarfönster. Du bör sedan se Hem och Sekretess sidor i menyraden.

  3. Välj Sekretess i menyraden. Sidan Sekretess i webbläsaren återger texten som anges i filen Privacy.cshtml.

    Skärmbild som visar sidan MyCoreApp-sekretess med följande text: Använd den här sidan för att beskriva webbplatsens sekretesspolicy.

  4. Gå tillbaka till Visual Studio och tryck sedan på Skift+F5- för att sluta felsöka. Den här åtgärden stänger projektet i webbläsarfönstret.

  5. Öppna Privacy.cshtml för redigering i Visual Studio. Ta sedan bort meningen Använd den här sidan för att beskriva webbplatsens sekretesspolicy och ersätta den med Sidan är under uppbyggnad från och med @ViewData["TimeStamp"].

    Skärmbild som visar filen Privacy.cshtml öppen i Visual Studio Code-redigeraren med den uppdaterade texten.

  6. Nu ska vi göra en kodändring. Välj Privacy.cshtml.cs. Rensa sedan using-direktiven överst i filen genom att välja följande genväg:

    För muspekaren över eller välj ett nedtonat using-direktiv. En Snabbåtgärder glödlampa visas under caret eller i vänstermarginalen. Välj glödlampan och välj sedan expandera pilen bredvid Ta bort onödiga användningar.

    Skärmbild som visar filen Privacy.cshtml i Visual Studio Code-redigeraren med knappbeskrivningen Snabbåtgärder öppen och Förhandsgranskningsändringar markerade.

    Välj nu Förhandsgranska ändringar för att se vad som ändrats.

    Skärmbild som visar dialogrutan Förhandsgranska ändringar. Dialogrutan visar direktivet som tas bort och förhandsgranskar kodändringen efter borttagningen.

    Välj Använd. Visual Studio tar bort onödiga using direktiv från filen.

  7. Skapa sedan en sträng för det aktuella datumet som är formaterat för din kultur eller region med hjälp av metoden DateTime.ToString.

    • Det första argumentet för metoden anger hur datumet ska visas. I det här exemplet används formatspecificeraren (d) som anger det korta datumformatet.
    • Det andra argumentet är objektet CultureInfo som anger kultur eller region för datumet. Det andra argumentet avgör bland annat språket för alla ord i datumet och vilken typ av avgränsare som används.

    Ändra brödtexten för metoden OnGet() i Privacy.cshtml.cs till följande kod:

    public void OnGet()
    {
       string dateTime = DateTime.Now.ToString("d", new CultureInfo("en-US"));
       ViewData["TimeStamp"] = dateTime;
    }
    
  8. Observera att följande using direktiv automatiskt läggs till överst i filen:

    using System.Globalization;
    

    System.Globalization innehåller klassen CultureInfo.

  9. Tryck på F5 för att öppna projektet i webbläsaren.

  10. Längst upp på webbplatsen väljer du Sekretess för att visa dina ändringar.

    Skärmbild som visar sidan Sekretess för MyCoreApp som innehåller de ändringar som gjorts för att lägga till datumet.

  11. Stäng webbläsaren, tryck på Skift+F5 för att sluta felsöka.

Ändra startsidan

  1. I Solution Explorerexpanderar du mappen Pages och väljer sedan Index.cshtml.

    Skärmbild som visar Index.cshtml markerat under noden Sidor i Solution Explorer.

    Filen Index.cshtml motsvarar din startsida i webbappen, som körs via en webbläsare.

    Skärmbild som visar startsidan för webbappen i webbläsarfönstret.

    I kodredigeraren visas HTML-kod för texten som visas på sidan Start.

    Skärmbild som visar filen Index.cshtml för startsidan i Visual Studio Code-redigeraren.

  2. Ersätt texten Välkommen med Hello World!

    Skärmbild som visar filen Index.cshtml i Visual Studio Code-redigeraren med texten

  3. Välj https eller tryck på Ctrl+F5 för att köra appen och öppna den i en webbläsare.

    Skärmbild som visar https-knappen markerad i verktygsfältet för Visual Studio.

  4. I webbläsaren ser du dina nya ändringar på sidan Start.

    Skärmbild som visar startsidan för webbappen i webbläsarfönstret. Den uppdaterade texten säger

  5. Stäng webbläsaren, tryck på Skift+F5 för att sluta felsöka och spara projektet. Nu kan du stänga Visual Studio.

Nästa steg

Grattis till att du har slutfört den här handledningen! Vi hoppas att du har lärt dig mer om C#, ASP.NET Core och Visual Studio IDE. Om du vill veta mer om hur du skapar en webbapp eller webbplats med C# och ASP.NET fortsätter du med följande självstudie:

Eller lär dig hur du containeriserar din webbapp med Docker: