Debuggen von Benutzercode mit nur eigenem Code

Nur eigenen Code ist ein Visual Studio-Debugfeature, das automatisch Aufrufe von System-, Framework- und anderem Nichtbenutzercode überspringt. Im Fenster Aufrufstapel werden diese Aufrufe von „Nur eigenen Code“ in Frames mit [externem Code] reduziert.

„Nur eigenen Code“ funktioniert in .NET- und C++-Projekten unterschiedlich.

Aktivieren oder Deaktivieren von "Nur eigenen Code"

Für die meisten Programmiersprachen ist „Nur eigenen Code“ standardmäßig aktiviert.

• Um „Nur eigenen Code“ in Visual Studio zu aktivieren bzw. zu deaktivieren, aktivieren bzw. deaktivieren Sie unter Extras>Optionen (oder Debuggen>Optionen) > >Debugging>Allgemein die Option Nur meinen Code aktivieren.

Nur mein Code (Debugoption)

Während einer Debugsitzung wird im Fenster Module zusammen mit dem jeweiligen Symbolladestatus angezeigt, welche Codemodule vom Debugger als eigener Code (Benutzercode) behandelt werden. Weitere Informationen erhalten Sie unter Informieren Sie sich darüber, wie der Debugger an Ihre App angefügt wird.

Im Fenster Aufrufstapel oder Tasks wird Nichtbenutzercode von „Nur eigenen Code“ in einen grauen, kommentierten Codeframe mit der Bezeichnung [External Code] reduziert.

Um den Code in einem reduzierten Frame mit [externem Code] anzuzeigen, klicken Sie mit der rechten Maustaste in das Fenster Aufrufstapel oder Tasks und wählen Sie im Kontextmenü Externen Code anzeigen aus. Die erweiterten externen Codezeilen ersetzen den Frame mit [externem Code] .

Durch Doppelklicken auf eine erweiterte externe Codezeile im Fenster Aufrufstapel wird die aufrufende Codezeile im Quellcode in Grün hervorgehoben. Bei DLLs oder anderen Modulen, die nicht gefunden oder geladen wurden, kann sich eine Seite „Symbol oder Quelle nicht gefunden“ öffnen.

„Nur eigenen Code“ in .NET

In .NET-Projekten werden von „Nur eigenen Code“ Symboldateien ( . pdb) und Programmoptimierungen verwendet, um Benutzer- und Nichtbenutzercode zu klassifizieren. Der .NET-Debugger betrachtet optimierte Binärdateien und nicht geladene .pdb-Dateien als Nichtbenutzercode.

Drei Compilerattribute beeinflussen außerdem, was der .NET-Debugger als Benutzercode ansieht:

• DebuggerNonUserCodeAttribute teilt dem Debugger mit, dass der Code, auf den er angewendet wird, kein Benutzercode ist.
• DebuggerHiddenAttribute blendet den Code für den Debugger aus, auch wenn Nur mein Code deaktiviert wird.
• DebuggerStepThroughAttribute veranlasst den Debugger, den vorliegenden Code nicht in Einzelschritten, sondern in Prozedurschritten zu durchlaufen.

Der .NET-Debugger betrachtet den gesamten anderen Code als Benutzercode.

Beim .NET-Debuggen:

• Debuggen>Einzelschritt (oder F11) in Nichtbenutzercode überspringt den Code bis zur nächsten Zeile des Benutzercodes.
• Debuggen>Rücksprung (oder UMSCHALT+F11) in Nichtbenutzercode springt zurück zur nächsten Zeile des Benutzercodes.

Wenn kein Benutzercode mehr vorhanden ist, wird das Debuggen bis zum Ende fortgesetzt, es wird ein weiterer Haltepunkt erreicht oder ein Fehler ausgelöst.

Wenn der Debugger Nichtbenutzercode unterbricht (z. B., wenn Sie Debuggen>Alle unterbrechen verwenden und Nichtbenutzercode anhalten), wird das Fenster Keine Quelle angezeigt. Sie können dann über den Befehl Debuggen>Schritt zur nächsten Zeile des Benutzercodes wechseln.

Wenn ein Ausnahmefehler im Nichtbenutzercode auftritt, unterbricht der Debugger an der Benutzercodezeile, in der die Ausnahme generiert wurde.

Wenn Ausnahmen (erste Chance) für die Ausnahme aktiviert sind, wird die aufrufende Benutzercodezeile im Quellcode grün hervorgehoben. Im Fenster Aufrufstapel wird ein mit Anmerkungen versehener Frame mit der Bezeichnung [Externer Code] angezeigt.

"Nur eigenen Code" in C++

Ab Visual Studio 2017, Version 15.8, wird „Nur eigenen Code“ für die Codeausführung unterstützt. Diese Funktion erfordert auch die Verwendung des Compilerschalters /JMC (Debuggen von „Nur eigenen Code“). Der Schalter ist in C++-Projekten standardmäßig aktiviert. Für das Fenster Aufrufliste und die Unterstützung der Aufrufliste in „Nur eigenen Code“ ist der /JMC-Schalter nicht erforderlich.

Um als Benutzercode klassifiziert zu werden, muss der PDB für die Binärdatei, die den Benutzercode enthält, vom Debugger geladen werden (verwenden Sie das Modulfenster , um den Ladestatus zu überprüfen).

Für das Verhalten von Aufrufstapeln, wie z. B. im Fenster Aufrufstapel, betrachtet „Nur eigenen Code“ in C++ nur diese Funktionen als Nichtbenutzercode:

• Funktionen mit entfernten Quellinformationen in ihrer Symboldatei.
• Funktionen, bei denen die Symboldateien angeben, dass keine Quelldatei vorhanden ist, die dem Stapelrahmen entspricht.
• Funktionen, die in .natjmc-Dateien im Ordner %VsInstallDirectory%\Common7\Packages\Debugger\Visualizers angegeben werden.

Für das Verhalten bei der Codeausführung betrachtet „Nur eigenen Code“ in C++ nur diese Funktionen als Nichtbenutzercode:

• Funktionen, für die die entsprechende PDB-Datei nicht in den Debugger geladen wurde.
• Funktionen, die in .natjmc-Dateien im Ordner %VsInstallDirectory%\Common7\Packages\Debugger\Visualizers angegeben werden.

Beim Debuggen in C++ wird IDE-generierter Code standardmäßig übersprungen. Beim Debuggen in C++ gilt:

• Bei Debuggen>Einzelschritt (oder F11) in IDE-generiertem Code wird der Code bis zur nächsten Zeile des Benutzercodes übersprungen, wenn Einzelschritt in IDE-generiertem Code aufgerufen wird.
• Debuggen>Rücksprung (oder UMSCHALT+F11) in IDE-generiertem Code wird bis zur nächsten Zeile des Benutzercodes (außerhalb des aktuellen Stapelrahmens) ausgeführt.

Wenn kein Benutzercode mehr vorhanden ist, wird das Debuggen bis zum Ende fortgesetzt, es wird ein weiterer Haltepunkt erreicht oder ein Fehler ausgelöst.

Wenn der Debugger den Nichtbenutzercode unterbricht (zum Beispiel, wenn Sie Debuggen>Alle unterbrechen verwenden und Nichtbenutzercode anhalten), wird die schrittweise Ausführung im Nichtbenutzercode weitergeführt.

Wenn der Debugger auf eine Ausnahme trifft, hält er bei der Ausnahme an, unabhängig davon, ob sie im Benutzer- oder Nichtbenutzercode auftritt. Die Optionen Vom Benutzercode unbehandelt im Dialogfeld Ausnahmeeinstellungen werden ignoriert.

Anpassen des Verhaltens von C++-Aufrufsstapel und -Codeschritten

Für C++-Projekte können Sie die Module, Quelldateien und Funktionen angeben, die das Fenster Aufrufstapel als Nichtbenutzercode behandelt, indem Sie sie in .natjmc-Dateien festlegen. Diese Anpassung gilt auch für Codeschritte, wenn Sie den neuesten Compiler verwenden (siehe „Nur eigenen Code“ in C++).

• Fügen Sie dem Ordner %VsInstallDirectory%\Common7\Packages\Debugger\Visualizers die NATJMC-Datei hinzu, um Nichtbenutzercode aller Benutzer des Visual Studio-Computers anzugeben.
• Fügen Sie die .natjmc-Datei zum Ordner %USERPROFILE%\Eigene Dokumente\<Visual Studio-Version>\Visualizers hinzu, um Nichtbenutzercode für einen einzelnen Benutzer anzugeben.

Eine .natjmc-Datei ist eine XML-Datei mit der folgenden Syntax:

<?xml version="1.0" encoding="utf-8"?>
<NonUserCode xmlns="http://schemas.microsoft.com/vstudio/debugger/jmc/2015">

  <!-- Modules -->
  <Module Name="ModuleSpec" />
  <Module Name="ModuleSpec" Company="CompanyName" />

  <!-- Files -->
  <File Name="FileSpec"/>

  <!-- Functions -->
  <Function Name="FunctionSpec" />
  <Function Name="FunctionSpec" Module ="ModuleSpec" />
  <Function Name="FunctionSpec" Module ="ModuleSpec" ExceptionImplementation="true" />

</NonUserCode>

Modulelementattribute

Dateielementattribute

Funktionselementattribute

Anpassen C++-Schrittverhaltens unabhängig von den Einstellungen für „Nur eigenen Code“

In C++-Projekten können Sie Prozedurschrittfunktionen angeben, indem Sie sie als NoStepInto-Funktionen in NATSTEPFILTER-Dateien auflisten. Die in .natstepfilter-Dateien aufgeführten Funktionen sind nicht von Einstellungen für „Nur eigenen Code“ abhängig. Eine NoStepInto-Funktion weist den Debugger an, die Funktion auch dann zu überspringen, wenn einige StepInto-Funktionen oder anderer Benutzercode aufgerufen werden. Im Gegensatz zu Funktionen, die in .natjmc aufgeführt sind, wechselt der Debugger in die erste Zeile des Benutzercodes innerhalb der NoStepInto-Funktion und führt sie schrittweise aus.

• Um Nichtbenutzercode für alle lokalen Visual Studio-Benutzer anzugeben, fügen Sie dem Ordner %VsInstallDirectory%\Common7\Packages\Debugger\Visualizers die .natstepfilter-Datei hinzu.
• Fügen Sie die .natstepfilter-Datei dem Ordner %USERPROFILE%\Eigene Dokumente\<Visual Studio-Version>\Visualizers hinzu, um Nichtbenutzercode für einen einzelnen Benutzer anzugeben.

Eine .natstepfilter-Datei ist eine XML-Datei mit der folgenden Syntax:

<?xml version="1.0" encoding="utf-8"?>
<StepFilter xmlns="http://schemas.microsoft.com/vstudio/debugger/natstepfilter/2010">
    <Function>
        <Name>FunctionSpec</Name>
        <Action>StepAction</Action>
    </Function>
    <Function>
        <Name>FunctionSpec</Name>
        <Module>ModuleSpec</Module>
        <Action>StepAction</Action>
    </Function>
</StepFilter>

Weitere Informationen zu NATSTEPFILTER- und NATJMC-Dateien

• Ab Visual Studio 2022, Version 17.6 können Sie .natjmc- und NATSTEPFILTER-Dateien direkt der Projektmappe oder dem Projekt hinzufügen.

• Syntaxfehler in .natstepfilter- und .natjmc-Dateien werden im Ausgabefenster des Debuggers nicht gemeldet.

• Im Gegensatz zu .natvis-Dateien, werden .natstepfilter- und .natjmc-Dateien nicht im laufenden Betrieb neu geladen. Stattdessen werden diese Dateien zu Beginn der Debugsitzung neu geladen.

• Bei Vorlagenfunktionen kann die Verwendung von <.*> oder <.* im Namen hilfreich sein.

"Nur eigenen Code" in JavaScript

Für ESPROJ-Projekte in Visual Studio 2022 verwendet Visual Studio Code eine launch.json Datei zum Konfigurieren und Anpassen des Debuggers. launch.json ist eine Debuggerkonfigurationsdatei.

Visual Studio fügt den Debugger nur an Benutzercode an. Bei .esproj-Projekten können Sie Benutzercode (d. h . just My Code settings) in Visual Studio mithilfe der skipFiles Einstellung in launch.json konfigurieren. Diese Einstellung funktioniert genauso wie die launch.json Einstellungen in VS Code. Weitere Informationen zu skipFiles finden Sie unter Überspringen von uninteressierendem Code.