Bearbeiten und Fortfahren (Visual C#)
Mit Hot Reload oder Bearbeiten und Fortfahren für C# können Sie beim Debuggen Codeänderungen im Unterbrechungs- oder Ausführungsmodus vornehmen. Die Änderungen können übernommen werden, ohne die Debugsitzung anhalten und neu starten zu müssen.
Die grundlegende Funktionalität von Hot Reload kann mit den meisten Typen von .NET-Apps und Framework-Versionen verwendet werden. Dazu gehören .NET Framework, .NET Core und .NET 5+ (sowohl für C# als auch für Visual Basic, soweit zutreffend). In diesem Szenario geht es darum, dass Sie – falls Sie den Debugger verwenden – davon ausgehen, dass Hot Reload verfügbar ist, und es ausprobieren.
Hot Reload unterstützt bis auf einige Ausnahmen die meisten Änderungen, die Sie möglicherweise während einer Debugsitzung vornehmen möchten. Hot Reload wird beispielsweise für optimierte Code- oder Debuggingsitzungen mit aktiviertem verwaltetem und nativem Debugger nicht unterstützt.
Informationen zu weiteren nicht unterstützten Szenarien finden Sie unter Unterstützte Codeänderungen (C# und Visual Basic). Wenn Sie versuchen, Codeänderungen in einem dieser Szenarien anzuwenden, wird ein Meldungsfeld mit dem Hinweis angezeigt, dass Hot Reload nicht unterstützt wird.
Verwenden von Hot Reload
Hot Reload für C# erfolgt automatisch, wenn Sie Codeänderungen im Unterbrechungsmodus vornehmen und dann das Debuggen mithilfe von Weiter, Schritt oder Nächste Anweisung festlegen fortsetzen. Wenn Sie Hot Reload bei Dateispeicherung anwenden auf TRUE festlegen, erfolgt dies auch automatisch beim Speichern einer Datei.
So aktivieren oder deaktivieren Sie Hot Reload
Wenn Sie sich in einer Debugsitzung befinden, beenden Sie das Debuggen (Debuggen>Debuggen beenden oder UMSCHALT+F5).
Öffnen Sie Extras>Optionen>Debugging>.NET/C++ Hot Reload, und aktivieren oder deaktivieren Sie das Feld Hot Reload und „Bearbeiten und Fortfahren“ beim Debuggen aktivieren.
Die Einstellungen werden beim Starten oder Neustarten der Debugsitzung aktiv.
So verwenden Sie das klassische „Bearbeiten und Fortfahren“
Nehmen Sie während des Debuggens im Unterbrechungsmodus eine Änderung an Ihrem Quellcode vor.
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 Fortfahren“ nicht unterstützt. Weitere Informationen finden Sie unter Unterstützte Codeänderungen (C# und Visual Basic).
Mit „Bearbeiten und Fortfahren“ für C# können Sie beim Debuggen Codeänderungen im Unterbrechungs- oder Ausführungsmodus vornehmen. Die Änderungen können übernommen werden, ohne die Debugsitzung anhalten und neu starten zu müssen. Im Ausführmodus ist der Quellcode-Editor schreibgeschützt.
„Bearbeiten und Fortfahren“ wird in UWP in Windows 10 oder höher sowie für x86- und x64-Apps unterstützt, die für .NET Framework 4.6 oder höhere Versionen vorgesehen sind (.NET Framework ist nur als Desktopversion verfügbar).
Die Funktion "Bearbeiten und Fortfahren" unterstützt bis auf einige Ausnahmen die meisten Änderungen, die Sie möglicherweise während einer Debugsitzung vornehmen möchten. „Bearbeiten und Fortfahren“ wird für optimierten, gemischten Code oder für SQL Server Common Language Runtime (CLR)-Integrationscode nicht unterstützt. Informationen zu weiteren nicht unterstützten Szenarien finden Sie unter Unterstützte Codeänderungen (C# und Visual Basic). Wenn Sie in einem dieser Szenarien „Bearbeiten und Fortfahren“ versuchen, wird ein Meldungsfeld mit dem Hinweis angezeigt, dass „Bearbeiten und Fortfahren“ nicht unterstützt wird.
Informationen zu weiteren nicht unterstützten Szenarien finden Sie unter Unterstützte Codeänderungen (C# und Visual Basic). Wenn Sie versuchen, Codeänderungen in einem dieser Szenarien anzuwenden, wird ein Meldungsfeld mit dem Hinweis angezeigt, dass Hot Reload nicht unterstützt wird.
Verwenden Sie „Bearbeiten und Fortfahren“
„Bearbeiten und Fortfahren“ für C# erfolgt automatisch, wenn Sie im Unterbrechungsmodus Änderungen am Code vornehmen und anschließend das Debuggen fortsetzen, indem Sie Weiter, Schritt oder Nächste Anweisung festlegen verwenden, oder wenn Sie im Debuggerfenster eine Funktion auswerten.
Aktivieren oder Deaktivieren von „Bearbeiten und Fortfahren“:
Wenn Sie sich in einer Debugsitzung befinden, beenden Sie das Debuggen (Debuggen>Debuggen beenden oder UMSCHALT+F5).
Aktivieren oder deaktivieren Sie in Tools>Optionen (oder Debuggen>Optionen) >Debuggen>Allgemein das Kontrollkästchen „Bearbeiten und Fortfahren“ aktivieren.
Die Einstellungen werden beim Starten oder Neustarten der Debugsitzung aktiv.
So verwenden Sie „Bearbeiten und Fortfahren“:
Nehmen Sie während des Debuggens im Unterbrechungsmodus eine Änderung an Ihrem Quellcode vor.
Klicken Sie im Menü Debuggen auf Weiter, Schritt oder Nächste Anweisung festlegen, oder werten Sie eine Funktion in einem Debuggerfenster aus.
Das Debuggen wird mit dem neuen, kompilierten Code fortgesetzt.
Einige Arten von Codeänderungen werden von „Bearbeiten und Fortfahren“ nicht unterstützt. Weitere Informationen finden Sie unter Unterstützte Codeänderungen (C# und Visual Basic).