Freigeben über


Bearbeiten und Fortfahren (Visual C#)

Mit "Hot Reload" oder "Edit and Continue for C#" können Sie Änderungen am Code im Unterbrechungs- oder Ausführungsmodus während des Debuggens vornehmen. Die Änderungen können angewendet werden, ohne die Debugsitzung beenden und neu starten zu müssen.

Die grundlegende Oberfläche "Hot Reload" funktioniert mit den meisten Typen von .NET-Apps und Framework-Versionen. Dazu gehören .NET Framework, .NET Core und .NET 5+ (sowohl für C# als auch für Visual Basic). Die Erwartung in diesem Szenario besteht darin, dass bei Verwendung des Debuggers davon ausgegangen wird, dass Hot Reload für Sie verfügbar ist, und versuchen Sie es!

Hot Reload unterstützt die meisten Änderungen, die Sie während einer Debugsitzung vornehmen möchten, aber es gibt einige Ausnahmen. Hot Reload wird beispielsweise für optimierte Code- oder Debuggingsitzungen mit aktiviertem verwaltetem und systemeigenem Debugger nicht unterstützt.

Informationen zu anderen nicht unterstützten Szenarien finden Sie unter Unterstützte Codeänderungen (C# und Visual Basic). Wenn Sie versuchen, Codeänderungen mit einem dieser Szenarien anzuwenden, wird ein Meldungsfeld mit dem Hinweis angezeigt, dass "Hot Reload" nicht unterstützt wird.

Hot Reload verwenden

"Hot Reload for C#" erfolgt automatisch, wenn Sie Codeänderungen im Unterbrechungsmodus vornehmen und dann das Debuggen mithilfe von "Continue", " Step" oder " Set Next Statement" fortsetzen. Wenn Sie " Hot Reload" beim Speichern der Datei auf "true" festlegen, erfolgt dies auch automatisch beim Speichern einer Datei.

So aktivieren oder deaktivieren Sie "Hot Reload":

  1. Wenn Sie sich in einer Debugsitzung befinden, beenden Sie das Debuggen (Debuggen>Debuggen beenden oder UMSCHALT + F5).
  1. Öffnen Sie den Bereich Werkzeuge-Optionen>, und erweitern Sie den Abschnitt Alle Einstellungen>>.

  2. Aktivieren oder deaktivieren Sie die gewünschten Optionen " Hot Reload aktivieren " für das Feature.

  1. Öffnen Sie das Dialogfeld "Toolsoptionen>", und erweitern Sie den Abschnitt"Debugging.NET>/C++Hot Reload".

  2. Wählen Oder deaktivieren Sie die gewünschten Optionen " Hot Reload aktivieren " für das Feature, und wählen Sie "OK" aus.

Die Einstellung wird wirksam, wenn Sie die Debugsitzung starten oder neu starten.

So verwenden Sie die klassische Bearbeitungs- und Fortsetzungsoberfläche:

  1. Nehmen Sie beim Debuggen im Unterbrechungsmodus eine Änderung am Quellcode vor.

  2. Wählen Sie im Menü " Debuggen " die Option "Weiter", " Schritt" oder "Nächste Anweisung festlegen" aus. Das Debuggen wird mit dem neuen kompilierten Code fortgesetzt.

Einige Arten von Codeänderungen werden von "Bearbeiten" und "Weiter" nicht unterstützt. Weitere Informationen finden Sie unter Unterstützte Codeänderungen (C# und Visual Basic).

Mit der Funktion "Bearbeiten und Fortfahren für C#" können Sie während des Debuggens im Unterbrechungs- oder Ausführungsmodus Änderungen an Ihrem Code vornehmen. Die Änderungen können angewendet werden, ohne die Debugsitzung beenden und neu starten zu müssen. Im Ausführungsmodus ist der Quell-Editor schreibgeschützt.

Bearbeiten und Fortsetzen wird in UWP in Windows 10 oder höher sowie x86- und x64-Apps unterstützt, die auf den .NET Framework 4.6-Desktop oder höher ausgerichtet sind (das .NET Framework ist nur eine Desktopversion).

"Bearbeiten" und "Weiter" unterstützen die meisten Änderungen, die Sie während einer Debugsitzung vornehmen möchten, aber es gibt einige Ausnahmen. Bearbeiten und Fortsetzen wird für optimierten, gemischten oder SQL Server Common Language Runtime (CLR)-Integrationscode nicht unterstützt. Informationen zu anderen nicht unterstützten Szenarien finden Sie unter Unterstützte Codeänderungen (C# und Visual Basic). Wenn Sie versuchen, mit einem dieser Szenarien fortzufahren, wird ein Meldungsfeld mit der Meldung angezeigt, dass "Bearbeiten" und "Weiter" nicht unterstützt wird.

Informationen zu anderen nicht unterstützten Szenarien finden Sie unter Unterstützte Codeänderungen (C# und Visual Basic). Wenn Sie versuchen, Codeänderungen mit einem dieser Szenarien anzuwenden, wird ein Meldungsfeld mit dem Hinweis angezeigt, dass "Hot Reload" nicht unterstützt wird.

Bearbeiten und Fortfahren verwenden

Bearbeiten und Fortfahren für C# erfolgt automatisch, wenn Sie Codeänderungen im Unterbrechungsmodus vornehmen, dann das Debuggen mithilfe von "Continue", "Step" oder " Set Next Statement" fortsetzen oder eine Funktion in einem Debuggerfenster auswerten.

So aktivieren oder deaktivieren Sie "Bearbeiten" und "Fortfahren":

  1. Wenn Sie sich in einer Debugsitzung befinden, beenden Sie das Debuggen (Debuggen>Debuggen beenden oder UMSCHALT+F5).

  2. Aktivieren oder deaktivieren Sie unter Extras>Optionen (oder Debuggen>Optionen) >Debuggen>Allgemein, das Kontrollkästchen Bearbeiten und Fortfahren aktivieren.

Die Einstellung wird wirksam, wenn Sie die Debugsitzung starten oder neu starten.

So verwenden Sie "Bearbeiten" und "Weiter":

  1. Nehmen Sie beim Debuggen im Unterbrechungsmodus eine Änderung am Quellcode vor.

  2. Wählen Sie im Menü " Debuggen " die Option "Weiter", " Schritt" oder " Nächste Anweisung festlegen" aus, oder bewerten Sie eine Funktion in einem Debuggerfenster.

    Das Debuggen wird mit dem neuen kompilierten Code fortgesetzt.

Einige Arten von Codeänderungen werden von "Bearbeiten" und "Weiter" nicht unterstützt. Weitere Informationen finden Sie unter Unterstützte Codeänderungen (C# und Visual Basic).