Zelfstudie: Fouten opsporen in een .NET-consoletoepassing met Visual Studio Code

In deze zelfstudie worden de hulpprogramma's voor foutopsporing geïntroduceerd die beschikbaar zijn in Visual Studio Code voor het werken met .NET-apps.

In deze zelfstudie worden de hulpprogramma's voor foutopsporing geïntroduceerd die beschikbaar zijn in GitHub Codespaces voor het werken met .NET-apps.

Vereiste voorwaarden

Deze zelfstudie werkt met de console-app die u maakt in Een .NET-consoletoepassing maken met behulp van Visual Studio Code.

Een onderbrekingspunt instellen

Een onderbrekingspunt onderbreekt tijdelijk de uitvoering van de toepassing voordat de regel met het onderbrekingspunt wordt uitgevoerd.

1. Visual Studio Code starten.

2. Open de map van het project dat u hebt gemaakt in Een .NET-consoletoepassing maken met behulp van Visual Studio Code.

3. Open het Program.cs-bestand .

4. Stel een onderbrekingspunt in op de regel die de naam, datum en tijd weergeeft door in de linkermarge van het codevenster te klikken. De linkermarge bevindt zich links van de regelnummers. Andere manieren om een onderbrekingspunt in te stellen, zijn door op F9 te drukken of run>toggle Breakpoint te kiezen in het menu terwijl de regel code is geselecteerd.

   Visual Studio Code geeft de regel aan waarop het onderbrekingspunt is ingesteld door een rode stip in de linkermarge weer te geven.

   

1. Open uw GitHub Codespace die u hebt gemaakt in Een .NET-consoletoepassing maken met behulp van Visual Studio Code.

2. Open het bestand HelloWorld.cs .

3. Stel een onderbrekingspunt in op de regel die de naam, datum en tijd weergeeft door in de linkermarge van het codevenster te klikken. De linkermarge bevindt zich links van de regelnummers. U kunt ook een onderbrekingspunt instellen door op F9 te drukken terwijl de coderegel is geselecteerd.

   

Debuggen starten

Debug en Release zijn de ingebouwde buildconfiguraties van .NET. U gebruikt de buildconfiguratie voor foutopsporing en de releaseconfiguratie voor de definitieve releasedistributie.

De opstartinstellingen van Visual Studio Code maken standaard gebruik van de buildconfiguratie voor foutopsporing, dus u hoeft deze niet te wijzigen voordat u fouten opspoort.

1. Open de weergave Foutopsporing door het pictogram Foutopsporing te selecteren in het menu aan de linkerkant.

   

2. Selecteer Uitvoeren en fouten opsporen. Als u hier om wordt gevraagd, selecteert u C# en vervolgens C#: Start het opstartproject. Andere manieren om het programma in de foutopsporingsmodus te starten, zijn door op F5 te drukken of Run>Start-foutopsporing te kiezen in het menu.

   

3. Als u wordt gevraagd configuratie starten te selecteren, selecteert u C#: Fouten opsporen in het actieve bestand.

4. Selecteer het tabblad Console voor foutopsporing om de vraag 'Wat is uw naam?' weer te geven voordat het programma wacht op een antwoord.

   

5. Voer een tekenreeks in het venster Foutopsporingsconsole in als reactie op de prompt om een naam en druk op Enter.

   De uitvoering van het programma stopt wanneer het onderbrekingspunt bereikt en voordat de Console.WriteLine methode wordt uitgevoerd. In de sectie Locals van het venster Variabelen worden de waarden weergegeven van variabelen die zijn gedefinieerd in de momenteel actieve methode.

   

GitHub Codespaces maakt standaard gebruik van de buildconfiguratie voor foutopsporing, dus u hoeft deze niet te wijzigen voordat u fouten opspoort.

1. Open de weergave Foutopsporing door het pictogram Foutopsporing te selecteren in het menu aan de linkerkant.

   

2. Selecteer Uitvoeren en fouten opsporen. Als u hier om wordt gevraagd, selecteert u C# als foutopsporingsprogramma en selecteert u vervolgens C#: Fouten opsporen in actief bestand als startconfiguratie.

3. Selecteer het tabblad Console voor foutopsporing om de vraag 'Wat is uw naam?' weer te geven voordat het programma wacht op een antwoord.

4. Voer een tekenreeks in het venster Foutopsporingsconsole in als reactie op de prompt om een naam en druk op Enter.

   De uitvoering van het programma stopt wanneer het onderbrekingspunt bereikt en voordat de Console.WriteLine methode wordt uitgevoerd. In de sectie Locals van het venster Variabelen worden de waarden weergegeven van variabelen die zijn gedefinieerd in de momenteel actieve methode.

   

De console voor foutopsporing gebruiken

In het venster Foutopsporingsconsole kunt u communiceren met de toepassing die u foutopsporing uitvoert. U kunt de waarde van variabelen wijzigen om te zien hoe dit van invloed is op uw programma.

1. Selecteer het tabblad Console voor foutopsporing .

2. Voer onder in het venster name = "Gracie" de prompt in en druk op Enter.

   

3. Voer currentDate = DateTime.Parse("2026-01-28T20:54:00Z").ToUniversalTime() in onderaan het Foutopsporingsconsole-venster en druk op Enter.

   In het venster Variabelen worden de nieuwe waarden van de name en currentDate variabelen weergegeven.

4. Ga door met de uitvoering van het programma door de knop Doorgaan op de werkbalk te selecteren. Een andere manier om door te gaan is door op F5 te drukken.

   

   De waarden die in het consolevenster worden weergegeven, komen overeen met de wijzigingen die u hebt aangebracht in de Console voor foutopsporing.

   

5. Druk op Enter om de toepassing af te sluiten en foutopsporing te stoppen.

Een voorwaardelijk onderbrekingspunt instellen

In het programma wordt de tekenreeks weergegeven die de gebruiker invoert. Wat gebeurt er als de gebruiker niets invoert? U kunt dit testen met een handige foutopsporingsfunctie, een voorwaardelijk onderbrekingspunt genoemd.

1. Klik met de rechtermuisknop (Ctrl-klik op macOS) op de rode stip die het onderbrekingspunt vertegenwoordigt. Selecteer in het contextmenu Het onderbrekingspunt bewerken om een dialoogvenster te openen waarmee u een voorwaardelijke expressie kunt invoeren.

   

2. Selecteer Expression in de vervolgkeuzelijst, voer de volgende voorwaardelijke expressie in en druk op Enter.

   String.IsNullOrEmpty(name)
   

   

   Telkens wanneer het onderbrekingspunt wordt bereikt, roept de debugger de String.IsNullOrEmpty(name) methode aan en pauzeert het alleen op deze regel als de methodeaanroep true retourneert.

   In plaats van een voorwaardelijke expressie kunt u een aantal treffers opgeven, waardoor de uitvoering van het programma wordt onderbroken voordat een instructie een opgegeven aantal keren wordt uitgevoerd. Een andere optie is om een filtervoorwaarde op te geven, waardoor de uitvoering van het programma wordt onderbroken op basis van dergelijke kenmerken als een thread-id, procesnaam of threadnaam.

3. Start het programma met foutopsporing door op F5 te drukken.

4. Druk op het tabblad Foutopsporingsconsole op Enter wanneer u wordt gevraagd uw naam in te voeren.

   Omdat aan de opgegeven voorwaarde (name is of nullString.Empty) is voldaan, stopt de uitvoering van het programma wanneer het onderbrekingspunt wordt bereikt en voordat de Console.WriteLine methode wordt uitgevoerd.

   In het venster Variabelen ziet u dat de waarde van de name variabele , ""of String.Empty.

5. Controleer of de waarde een lege tekenreeks is door de volgende instructie in te voeren bij de prompt van de console voor foutopsporing en op Enter te drukken. Het resultaat is true.

   name == String.Empty
   

6. Selecteer de knop Doorgaan op de werkbalk om door te gaan met de uitvoering van het programma.

7. Druk op Enter om het programma af te sluiten en foutopsporing te stoppen.

8. Wis het onderbrekingspunt door op de stip in de linkermarge van het codevenster te klikken. Andere manieren om een onderbrekingspunt te verwijderen zijn door op F9 te drukken of Run > Onderbrekingspunt aan/uitzetten in het menu te kiezen terwijl de coderegel is geselecteerd.

9. Als u een waarschuwing krijgt dat de onderbrekingspuntvoorwaarde verloren gaat, selecteert u Onderbrekingspunt verwijderen.

Een programma doorlopen

Visual Studio Code stelt u ook in staat om regel voor regel door een programma te lopen en de uitvoering ervan te bewaken. Normaal gesproken stelt u een onderbrekingspunt in en volgt u de programmastroom door een klein deel van uw programmacode. Omdat dit programma klein is, kunt u het hele programma doorlopen.

1. Stel een onderbrekingspunt in op de coderegel waarin de prompt 'Wat is uw naam?' wordt weergegeven.

2. Druk op F5 om foutopsporing te starten.

   Visual Studio Code markeert de breakpoint-lijn.

   Op dit moment ziet u in het venster Variabelen dat de args matrix leeg is, en dat name en currentDate standaardwaarden hebben.

3. Selecteer Step Into op de werkbalk Foutopsporing of druk op F11.

   

   Visual Studio Code markeert de volgende regel.

4. Visual Studio Code voert de Console.WriteLine naamprompt uit en markeert de volgende uitvoeringsregel. De volgende regel is de Console.ReadLine voor de name. Het venster Variabelen is ongewijzigd en op het tabblad Terminal wordt de prompt 'Wat is uw naam?' weergegeven.

5. Selecteer Stap in of druk op F11.

   Visual Studio Code markeert de name variabeletoewijzing. In het venster Variabelen ziet u dat dat name nog steeds nullis.

6. Reageer op de prompt door een tekenreeks in te voeren op het tabblad Terminal en op Enter te drukken.

   Het tabblad Foutopsporingsconsole geeft mogelijk niet de tekenreeks weer die u invoert terwijl u deze invoer invoert, maar de Console.ReadLine methode legt uw invoer vast.

7. Selecteer Stap in of druk op F11.

   Visual Studio Code markeert de currentDate variabeletoewijzing. In het venster Variabelen ziet u de waarde die wordt geretourneerd door de aanroep naar de Console.ReadLine methode. Op het tabblad Terminal wordt de tekenreeks weergegeven die u bij de prompt hebt ingevoerd.

8. Selecteer Stap in of druk op F11.

   Het venster Variabelen toont de waarde van de currentDate variabele na de toewijzing van de DateTime.Now eigenschap.

9. Selecteer Stap in of druk op F11.

   Visual Studio Code roept de methode aan Console.WriteLine(String, Object, Object) . In het consolevenster wordt de opgemaakte tekenreeks weergegeven.

10. Selecteer Stap uit of druk op Shift+F11.

    

    In de terminal wordt "Druk op een willekeurige toets om af te sluiten..."

11. Druk op een willekeurige toets om het programma af te sluiten.

Gebruik de Release-buildconfiguratie

Nadat u de foutopsporingsversie van uw toepassing hebt getest, moet u ook de releaseversie compileren en testen. De releaseversie bevat compileroptimalisaties die van invloed kunnen zijn op het gedrag van een toepassing. Compileroptimalisaties die zijn ontworpen om de prestaties te verbeteren, kunnen bijvoorbeeld raceomstandigheden in multithreaded-toepassingen creëren.

Als u de releaseversie van uw consoletoepassing wilt bouwen en testen, opent u Terminal en voert u de volgende opdracht uit:

dotnet run --configuration Release

Als u de releaseversie van uw consoletoepassing wilt bouwen en testen, voert u de volgende opdracht uit in de terminal:

dotnet run --configuration Release HelloWorld.cs

Volgende stappen

In deze zelfstudie hebt u hulpprogramma's voor foutopsporing in Visual Studio Code gebruikt. In de volgende handleiding publiceert u een uitrolbare versie van de app.

Een .NET-consoletoepassing publiceren met Visual Studio Code