Självstudie: Lär dig att felsöka C#-kod med Hjälp av Visual Studio

Den här artikeln beskriver funktionerna i Visual Studio-felsökningsprogrammet i en stegvis genomgång. Om du vill ha en vy på högre nivå över felsökningsfunktionerna kan du läsa Titta först på felsökningsprogrammet. När du felsöker din appinnebär det vanligtvis att du kör applikationen med debuggern kopplad. När du gör den här uppgiften tillhandahåller felsökningsprogrammet många sätt att se vad din kod gör när den körs. Du kan gå igenom koden och titta på de värden som lagras i variabler; du kan ange övervakningar på variabler för att se när värdena ändras; du kan undersöka exekveringsvägen för koden, se om en gren av koden är i drift och så vidare. Om den här övningen är första gången du försöker felsöka kod kanske du vill läsa Felsökning för absoluta nybörjare innan du går igenom den här artikeln.

Även om demoappen är C#, gäller de flesta funktionerna för C++, Visual Basic, F#, Python, JavaScript och andra språk som stöds av Visual Studio (F# stöder inte Redigera och fortsätt. F# och JavaScript stöder inte fönstret Autos). Skärmbilderna finns i C#.

I den här handledningen kommer du att:

• Starta felsökningsprogrammet och tryck på brytpunkter.
• Lär dig kommandon för att stega igenom kod i felsökningsprogrammet
• Granska variabler i datatips och felsökningsfönster
• Granska anropsstacken

Förutsättningar

Du måste ha Visual Studio 2022 installerat och .NET-skrivbordsutveckling arbetsbelastning.

Om du inte redan har installerat Visual Studio går du till Visual Studio-nedladdningar sidan för att installera den kostnadsfritt.

Om du redan har Visual Studio men .NET-skrivbordsutveckling arbetsbelastningen inte är installerad går du till Verktyg>Hämta verktyg och funktioner..., som startar Visual Studio Installer. I Visual Studio Installationsprogrammet väljer du arbetsbelastningen .NET-skrivbordsutveckling och väljer sedan Ändra.

Skapa ett projekt

Först skapar du ett .NET Core-konsolprogramprojekt. Projekttypen levereras med alla mallfiler du behöver, innan du ens har lagt till något!

1. Öppna Visual Studio. Om startfönstret inte är öppet väljer du Fil>Startfönster.

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

3. I fönstret Skapa ett nytt projekt anger du konsol i sökrutan. Välj sedan C# i listan Språk och välj sedan Windows i listan Plattform.

   När du har tillämpat språk- och plattformsfilter väljer du mallen Console App och väljer sedan Nästa.

   

   Not

   Om du inte ser mallen Console App kan du installera den från fönstret Skapa ett nytt projekt. I Hittar du inte det du letar efter? meddelande väljer du länken Installera fler verktyg och funktioner. Välj sedan arbetsbelastningen .NET Desktop Development i Visual Studio Installer.

4. I fönstret Konfigurera ditt nya projekt anger du GetStartedDebugging i rutan Projektnamn. Välj sedan Nästa.

5. I fönstret Ytterligare information kontrollerar du att .NET 8.0 är markerat i listrutan Framework och välj sedan Skapa.

Visual Studio öppnar det nya projektet.

Skapa programmet

I Program.csersätter du all standardkod med följande kod:

using System;

class ArrayExample
{
   static void Main()
   {
      char[] letters = { 'f', 'r', 'e', 'd', ' ', 's', 'm', 'i', 't', 'h'};
      string name = "";
      int[] a = new int[10];
      for (int i = 0; i < letters.Length; i++)
      {
         name += letters[i];
         a[i] = i + 1;
         SendMessage(name, a[i]);
      }
      Console.ReadKey();
   }

   static void SendMessage(string name, int msg)
   {
      Console.WriteLine("Hello, " + name + "! Count to " + msg);
   }
}

Starta felsökningsprogrammet!

För det mesta använder vi kortkommandon här eftersom det är ett snabbt sätt att köra felsökningskommandon. Motsvarande kommandon, till exempel verktygsfält eller menykommandon, noteras också.

1. Starta felsökningsprogrammet genom att välja F5eller välja knappen Felsöka mål i verktygsfältet Standard, eller välj knappen Starta felsökning i verktygsfältet Felsökning eller välj Felsök>Starta felsökning från menyraden.

   

   F5 startar appen med felsökningsprogrammet kopplat till appprocessen. Eftersom vi inte har gjort något speciellt för att undersöka koden, körs appen till slutförande och du ser konsolens utdata.

   Hello, f! Count to 1
   Hello, fr! Count to 2
   Hello, fre! Count to 3
   Hello, fred! Count to 4
   Hello, fred ! Count to 5
   Hello, fred s! Count to 6
   Hello, fred sm! Count to 7
   Hello, fred smi! Count to 8
   Hello, fred smit! Count to 9
   Hello, fred smith! Count to 10
   

2. Om du vill stoppa felsökningsprogrammet väljer du Skift+F5eller väljer knappen Sluta felsöka i verktygsfältet Felsök eller väljer Felsöka>Sluta felsöka från menyraden.

   

3. I konsolfönstret väljer du valfri nyckel för att stänga konsolfönstret.

Ange en brytpunkt och starta felsökningsprogrammet

1. I for-loopen för funktionen Main anger du en brytpunkt genom att klicka på vänstermarginalen på följande kodrad:

   name += letters[i];

   En röd cirkel visas där du anger brytpunkten.

   

   Brytpunkter är en viktig funktion i tillförlitlig felsökning. Du kan ange brytpunkter där du vill att Visual Studio ska pausa koden som körs så att du kan titta på värdena för variabler eller minnesbeteendet, eller veta om en kodgren körs eller inte.

2. Börja felsöka genom att välja F5, eller välj knappen Felsöka mål i verktygsfältet Standard, eller välj knappen Starta felsökning i verktygsfältet Felsök eller välj Felsök>Starta felsökning från menyraden. Appen startar och felsökningsprogrammet körs till den kodrad där du anger brytpunkten.

   

   Den gula pilen pekar på instruktionen där felsökningsprogrammet pausades. Appens körning pausas vid samma tidpunkt och instruktionen har ännu inte utförts.

   När appen inte körs startar F5 felsökningsprogrammet, som kör appen tills den når den första brytpunkten. Om appen pausas vid en brytpunkt fortsätter F5- att köra appen tills den når nästa brytpunkt.

   Brytpunkter är en användbar funktion när du känner till den rad eller det kodavsnitt som du vill granska i detalj. Mer information om de olika typerna av brytpunkter som du kan ange, till exempel villkorliga brytpunkter, finns i Använda brytpunkter.

Navigera i kod och inspektera data med hjälp av datatips

1. När kodkörningen är pausad vid name += letters[i]-satsen, håll muspekaren över variabeln letters, för att se ett datatips som visar matrisens storlek och elementtyp char[10].

   Anteckning

   En av de mest användbara funktionerna i felsökningsprogrammet är dess möjlighet att inspektera en variabel. När du försöker felsöka ett problem försöker du ofta ta reda på om variabler har värden som du förväntar dig vid en viss tidpunkt. Att visa informationstips är ett bra sätt att säkerställa det.

2. Expandera variabeln letters för att visa alla dess matriselement och deras värden.

   

3. Hovra över variabeln name för att se dess aktuella värde, som är en tom sträng.

4. Om du vill gå vidare med felsökningsprogrammet till nästa instruktion väljer du F10eller väljer knappen Steg över i verktygsfältet Felsök eller väljer Felsöka>Steg över i menyraden. Välj F10 två gånger till för att gå förbi SendMessage-metodanropet.

   F10 avancerar felsökningsprogrammet utan att gå in i funktion eller metoder, även om koden fortfarande körs. På så sätt hoppades vi över att felsöka koden i metoden SendMessage, som vi inte är intresserade av just nu.

5. Om du vill iterera genom for-loopen några gånger väljer du F10 upprepade gånger. Under varje loop-iteration pausar du vid brytpunkten och hovra sedan över variabeln name för att kontrollera dess värde i datatipset.

   

   Värdet för variabeln ändras med varje iteration av for-loopen, som visar värden för f, sedan fr, sedan freoch så vidare. Om du vill avancera felsökningsprogrammet snabbare genom loopen väljer du F5- i stället, som går vidare till brytpunkten i stället för nästa instruktion.

6. Medan kodkörningen pausas i for-loopen för Main-metoden väljer du F11eller väljer knappen Steg till i verktygsfältet Felsökning eller väljer Felsöka>Steg in i från menyraden tills du når SendMessage-metodanropet.

   Felsökningsprogrammet bör pausas på den här kodraden:

   SendMessage(name, a[i]);

7. Om du vill gå in på metoden SendMessage väljer du F11 igen.

   Den gula pekaren avancerar till metoden SendMessage.

   

   F11 hjälper dig att undersöka körningsflödet för din kod mer ingående. Om du vill gå in på en metod från ett metodanrop väljer du F11. Som standard hoppar felsökningsprogrammet över steg till metoder som inte är använda. För att lära dig mer om att felsöka kod som inte är användarkod, se Just My Code.

   När du har felsökt SendMessage-metoden är du redo att återgå till for-loopen för metoden main.

8. Om du vill lämna metoden SendMessage väljer du Skift+F11eller väljer knappen Steg ut i verktygsfältet Felsök eller väljer Felsöka>Steg ut från menyraden.

   Step Out återupptar appkörningen och avancerar felsökningsprogrammet tills den aktuella metoden eller funktionen returneras.

   Du ser att den gula pekaren är tillbaka i for-loopen i Main-metoden, pausad vid SendMessage-metodanropet. Mer information om olika sätt att gå igenom koden finns i Navigera kod i felsökningsprogrammet.

Navigera kod med Kör för att klicka

1. Välj F5 för att gå vidare till brytpunkten igen.

2. Hovra över Console.WriteLine-metodanropet i SendMessage-metoden i kodredigeraren tills knappen Kör för att klicka på visas. Knappens beskrivning visar "Kör processen hit."

   

3. Välj knappen Kör för att klicka på. Alternativt, med markören på uttrycket Console.WriteLine , välj Ctrl+F10. Du kan också högerklicka på Console.WriteLine-metodanropet och välja Kör till markör från sammanhangsmenyn.

   Felsökningsprogrammet går vidare till Console.WriteLine-metodanropet.

   Att använda knappen Kör för att klicka på liknar att ange en tillfällig brytpunkt och är praktiskt för att snabbt komma runt inom en synlig region i din appkod i en öppen fil.

Starta om appen snabbt

Om du vill köra appen igen från början i felsökningsprogrammet väljer du Ctrl+Skift+F5eller väljer knappen Starta om i verktygsfältet Felsöka eller väljer Felsök>Starta om från menyraden.

Starta om stoppar felsökningsprogrammet och startar sedan om det i ett steg. När felsökningsprogrammet startas om körs den till den första brytpunkten, som är den brytpunkt som du tidigare angav i for-loopen, och pausa sedan.

Granska variabler med fönstren Autos och Lokala

Windows Autos och Locals visar variabelvärden när du felsöker. Fönstren är endast tillgängliga under en felsökningssession. Fönstret Autos visar variabler som används på den aktuella raden som felsökningsprogrammet finns på och på föregående rad. Fönstret Locals visar variabler som definierats i det lokala omfånget, vilket vanligtvis är den aktuella funktionen eller metoden.

1. När felsökningsprogrammet är pausat visar du fönstret Autos längst ned i kodredigeraren.

   Om fönstret Autos är stängt väljer du Ctrl+D, Aeller väljer Felsöka>Windows>Autos från menyraden.

2. När felsökningsprogrammet fortfarande är pausat visar du fönstret Locals på en flik bredvid fönstret Autos.

   Om fönstret Locals är stängt väljer du Ctrl+D, Leller väljer Felsöka>Windows>Locals.

3. I fönstret Locals expanderar du variabeln letters för att se dess matriselement och deras värden.

   

Mer information om fönstren Autos och Locals finns i Granska variabler i fönstren Autos och Locals.

Ställ in en klocka

Du kan ange en variabel eller ett uttryck som du vill hålla ett öga på när du går igenom kod genom att lägga till den i fönstret Watch.

1. När felsökningsprogrammet har pausats högerklickar du på variabeln name och väljer Lägg till klocka.

   Fönstret Watch öppnas som standard längst ned i kodredigeraren.

2. Nu när du har angett en klocka för variabeln name går du igenom koden för att se värdet för name variabeländring med varje for loop-iteration.

   Till skillnad från de andra variabelfönstren visar fönstret Watch alltid de variabler som du tittar på. Variabler som ligger utanför omfånget visas som otillgängliga.

För mer information om övervakningsfönstret , se övervaka variabler med övervakningsfönster.

Granska anropsstacken

Anropsstacken kan hjälpa dig att förstå körningsflödet för din app genom att visa i vilken ordning metoder och funktioner anropas.

1. När felsökningsprogrammet har pausats i for-loopen, visar du fönstret Anropsstack, som öppnas som standard i den nedre högra rutan i kodredigeraren.

   Om fönstret Anropsstack är stängt väljer du Ctrl+D, C, eller väljer Debugga>Windows>Anropsstack från menyraden.

   I fönstret Stackanrop visas den gula pekaren på den aktuella metoden Main.

2. Välj F11 några gånger tills felsökningsprogrammet pausas i metoden SendMessage.

   Den översta raden i fönstret Call Stack visar den aktuella funktionen, som är metoden SendMessage. Den andra raden visar att metoden SendMessage anropades från metoden Main.

   

   Not

   Fönstret Call Stack liknar felsökningsperspektivet i vissa IDE:er, till exempel Eclipse.

   I fönstret Anropsstack kan du dubbelklicka på en kodrad för att gå till källkoden, vilket ändrar det aktuella omfånget som inspekteras av felsökaren. Den här åtgärden avancerar inte felsökningsprogrammet.

   Du kan också använda högerklicksmenyer i fönstret anropsstack för att göra andra saker. Du kan till exempel infoga brytpunkter i angivna funktioner, avancera felsökningsprogrammet med hjälp av Kör till marköreller gå till källkod.

Mer information om Call Stackfinns i How to: Examine the Call Stack.

Nästa steg

I den här självstudien har du lärt dig hur du startar felsökningsprogrammet, går igenom kod och inspekterar variabler. Du kanske vill titta på felsökningsfunktioner på hög nivå tillsammans med länkar till mer information.

Första titt på felsökaren