Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
de9da4a
edit
v-albemi Mar 12, 2026
0e8ed48
edit
v-albemi Mar 12, 2026
886403f
edit
v-albemi Mar 12, 2026
a127771
edit
v-albemi Mar 12, 2026
6071dbf
edit
v-albemi Mar 12, 2026
269cf2b
edit
v-albemi Mar 12, 2026
e7685d7
edit
v-albemi Mar 12, 2026
5b67b25
edit
v-albemi Mar 12, 2026
007fc87
Add details and links related to GH Copilot modernization agent
Mikejo5000 Mar 20, 2026
0d1a8e6
Complete rebranding of Edit and Continue
Mikejo5000 Mar 23, 2026
28d38f6
Apply suggestions from code review
Mikejo5000 Mar 23, 2026
888b05f
Apply suggestions from code review
Mikejo5000 Mar 23, 2026
8936530
Apply suggestion from @github-actions[bot]
Mikejo5000 Mar 23, 2026
3aad52c
Apply suggestion from @github-actions[bot]
Mikejo5000 Mar 23, 2026
39f1de6
Apply suggestion from @github-actions[bot]
Mikejo5000 Mar 23, 2026
3bce4e5
Apply suggestion from @github-actions[bot]
Mikejo5000 Mar 23, 2026
1a27a5c
Apply suggestion from @github-actions[bot]
Mikejo5000 Mar 23, 2026
6a6a583
Bump actions/github-script from 7 to 8
dependabot[bot] Mar 23, 2026
01cba11
Bump actions/checkout from 4 to 6
dependabot[bot] Mar 23, 2026
b7d26eb
Art updates and metadata fixes
Mikejo5000 Mar 23, 2026
390d1bc
Merge pull request #15181 from MicrosoftDocs/dependabot/github_action…
ghogen Mar 24, 2026
3f3ef7c
Merge pull request #15182 from MicrosoftDocs/dependabot/github_action…
ghogen Mar 24, 2026
ea59f87
TOC edits
Mikejo5000 Mar 24, 2026
e9d021c
Improve image captions in hot-reload.md
JamesJBarnett Mar 24, 2026
7920a40
Merge pull request #15175 from Mikejo5000/mikejo-ai9
prmerger-automator[bot] Mar 24, 2026
c8891af
Merge pull request #15179 from Mikejo5000/mikejo-ai8
JamesJBarnett Mar 24, 2026
64d79ef
Merge pull request #15131 from v-albemi/vs-screenshots-58
JamesJBarnett Mar 24, 2026
e244a8f
Merge pull request #15183 from MicrosoftDocs/main
learn-build-service-prod[bot] Mar 24, 2026
780325d
Merging changes synced from https://github.com/MicrosoftDocs/visualst…
Mar 24, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/workflows/add-awp-metadata.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ jobs:

steps:
- name: Checkout PR
uses: actions/checkout@v4
uses: actions/checkout@v6
with:
# Checkout PR head via pull refs on the base repository.
# This avoids direct access to contributor forks during checkout.
Expand Down Expand Up @@ -214,7 +214,7 @@ jobs:

- name: Post review suggestions for metadata updates
if: steps.commit.outputs.status == 'fork' || steps.commit.outputs.status == 'push-failed'
uses: actions/github-script@v7
uses: actions/github-script@v8
with:
script: |
const fs = require('fs');
Expand Down
2 changes: 1 addition & 1 deletion docs/debugger/debugger-feature-tour.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Visual Studio 2022 supports live code editing while debugging. For detailed info

- [Write and debug running code](hot-reload.md)
- [Write and debug running XAML code with XAML Hot Reload](../xaml-tools/xaml-hot-reload.md)
- [Edit and Continue](/visualstudio/debugger/how-to-enable-and-disable-edit-and-continue)
- [Configure Hot Reload (previously called Edit and Continue)](/visualstudio/debugger/how-to-enable-and-disable-edit-and-continue)

::: moniker-end

Expand Down
27 changes: 14 additions & 13 deletions docs/debugger/edit-and-continue-visual-basic.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Edit and Continue (Visual Basic)"
description: Edit and Continue is available for Visual Basic projects. Learn what edits are supported, and how to can control whether, and when, your edits are applied.
ms.date: "08/15/2023"
title: "Hot Reload (Visual Basic)"
description: Hot Reload (previously called Edit and Continue) is available for Visual Basic projects. Learn what edits are supported and how to control when edits are applied.
ms.date: "03/23/2026"
ms.topic: how-to
dev_langs:
- "CSharp"
Expand All @@ -18,25 +18,26 @@ author: "mikejo5000"
ms.author: "mikejo"
manager: mijacobs
ms.subservice: debug-diagnostics
ms.custom: awp-ai
---
# Edit and Continue (Visual Basic)
# Hot Reload (Visual Basic)

::: moniker range=">=vs-2022"
Hot Reload, previously called Edit and Continue, is a feature for Visual Basic debugging that enables you to change your code while it's executing in Break mode. After code edits have been applied, you can resume code execution with the new edits in place and see the effect.
::: moniker-end


You can use the Edit and Continue feature whenever you enter Break mode. In Break mode, the instruction pointer, a yellow arrowhead in the source window, points to the line containing an executable statement in a method or property body that will be executed next.
You can use Hot Reload whenever you enter Break mode. In Break mode, the instruction pointer, a yellow arrowhead in the source window, points to the line containing an executable statement in a method or property body that will be executed next.

When you make an unauthorized edit, the change is marked with a purple wavy underline and a task is displayed in the Task List. You must undo an unauthorized edit if you want to continue to use Edit and Continue. Certain unauthorized edits may be permitted if done outside Edit and Continue. If you want to retain the results of such an unauthorized edit, you must stop debugging and restart your application.
When you make an unauthorized edit, the change is marked with a purple wavy underline and a task is displayed in the Task List. You must undo an unauthorized edit if you want to continue to use Hot Reload. Certain unauthorized edits may be permitted if done outside Hot Reload. If you want to retain the results of such an unauthorized edit, you must stop debugging and restart your application.

Edit and Continue is supported in UWP apps for Windows 10 or later, and x86 and x64 apps that target the .NET Framework 4.6 desktop or later versions (the .NET Framework is a desktop version only).
Hot Reload is supported in UWP apps for Windows 10 or later, and x86 and x64 apps that target the .NET Framework 4.6 desktop or later versions (the .NET Framework is a desktop version only).

Edit and Continue supports most changes you might want to make during a debugging session, but there are some exceptions. Edit and Continue isn't supported when you start debugging using **Attach to Process**. Edit and Continue isn't supported for optimized code or mixed managed and native code. For more information, see [Supported Code Changes (C# and Visual Basic)](../debugger/supported-code-changes-csharp.md).
Hot Reload supports most changes you might want to make during a debugging session, but there are some exceptions. Hot Reload isn't supported when you start debugging using **Attach to Process**. Hot Reload isn't supported for optimized code or mixed managed and native code. For more information, see [Supported Code Changes (C# and Visual Basic)](../debugger/supported-code-changes-csharp.md).

## Apply edits in Break Mode with Edit and Continue
## Apply edits in Break Mode with Hot Reload

You can use Edit and Continue to edit your code in Break mode, and then continue without stopping and restarting execution.
You can use Hot Reload to edit your code in Break mode, and then continue without stopping and restarting execution.

To edit code in Break mode:

Expand All @@ -57,7 +58,7 @@ To edit code in Break mode:
For more information, see [Supported Code Changes (C# and Visual Basic)](../debugger/supported-code-changes-csharp.md).

> [!NOTE]
> If you attempt to make a code change that is not allowed by Edit and Continue, your edit will be underlined by a purple wavy line and a task will appear in the Task List. You won't be able to continue code execution unless you undo the illegal code change.
> If you attempt to make a code change that is not allowed by Hot Reload, your edit will be underlined by a purple wavy line and a task will appear in the Task List. You won't be able to continue code execution unless you undo the illegal code change.

3. On the **Debug** menu, click **Continue** to resume execution.

Expand All @@ -66,5 +67,5 @@ To edit code in Break mode:
## Related content

- [Supported Code Changes (C# and Visual Basic)](../debugger/supported-code-changes-csharp.md)
- [Edit and Continue](/visualstudio/debugger/how-to-enable-and-disable-edit-and-continue)
- [Configure Edit and Continue](../debugger/how-to-enable-and-disable-edit-and-continue.md)
- [Configure Hot Reload](/visualstudio/debugger/how-to-enable-and-disable-edit-and-continue)
- [Hot Reload settings and options](../debugger/how-to-enable-and-disable-edit-and-continue.md)
21 changes: 11 additions & 10 deletions docs/debugger/edit-and-continue-visual-cpp.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Edit and Continue in your C++ projects
description: Edit and Continue is available for C++ projects. Learn what edits are supported, and how to can control whether, and when, your edits are applied.
ms.date: "05/31/2018"
title: Hot Reload in your C++ projects
description: Hot Reload (previously called Edit and Continue) is available for C++ projects. Learn what edits are supported and how to control when edits are applied.
ms.date: "03/23/2026"
ms.topic: how-to
f1_keywords:
- "vs.debug.ENC.welcome"
Expand All @@ -18,8 +18,9 @@ author: "mikejo5000"
ms.author: "mikejo"
manager: mijacobs
ms.subservice: debug-diagnostics
ms.custom: awp-ai
---
# Edit and Continue (C++)
# Hot Reload (C++)

::: moniker range=">=vs-2022"

Expand All @@ -29,7 +30,7 @@ You can use Hot Reload, previously called Edit and Continue, in C++ projects. Fo

The [/Zo (Enhance Optimized Debugging)](/cpp/build/reference/zo-enhance-optimized-debugging) compiler option adds additional information to .pdb (symbol) files for binaries compiled without the [/Od (Disable (Debug))](/cpp/build/reference/od-disable-debug) option.

The `/Zo` option disables Edit and Continue, as described in [How to: Debug Optimized Code](../debugger/how-to-debug-optimized-code.md).
The `/Zo` option disables Hot Reload (formerly called Edit and Continue), as described in [How to: Debug Optimized Code](../debugger/how-to-debug-optimized-code.md).

::: moniker range=">=vs-2022"

Expand Down Expand Up @@ -83,15 +84,15 @@ You might want to disable the automatic invocation of Hot Reload if you're makin

## <a name="BKMK_How_to_apply_code_changes_explicitly"></a> Apply code changes explicitly

In C++, Edit and Continue can apply code changes in two ways. Code changes can be applied implicitly, when you choose an execution command, or explicitly, using the **Apply Code Changes** command.
In C++, Hot Reload can apply code changes in two ways. Code changes can be applied implicitly, when you choose an execution command, or explicitly, using the **Apply Code Changes** command.

When you apply code changes explicitly, your program remains in break mode - no execution occurs.

- To apply code changes explicitly, on the **Debug** menu, choose **Apply Code Changes**.

## <a name="BKMK_How_to_stop_code_changes"></a> How to stop code changes

While Edit and Continue is in the process of applying code changes, you can stop the operation.
While Hot Reload is in the process of applying code changes, you can stop the operation.

To stop applying code changes:

Expand All @@ -103,17 +104,17 @@ To stop applying code changes:

## <a name="BKMK_How_to_reset_the_point_of_execution"></a> Reset the point of execution

Some code changes can cause the point of execution to move to a new location when Edit and Continue applies the changes. The feature places the point of execution as accurately as possible, but the results might not be correct in all cases.
Some code changes can cause the point of execution to move to a new location when Hot Reload applies the changes. The feature places the point of execution as accurately as possible, but the results might not be correct in all cases.

In C++, a dialog box informs you when the point of execution changes. You should verify that the location is correct before you continue debugging. If it isn't correct, use the **Set Next Statement** command. For more information, see [Set the next statement to execute](./navigating-through-code-with-the-debugger.md#BKMK_Set_the_next_statement_to_execute).

## <a name="BKMK_How_to_work_with_stale_code"></a> Work with stale code

In some cases, Edit and Continue can't apply code changes to the executable immediately, but might be able to apply the code changes later if you continue debugging. This scenario happens if you edit a function that calls the current function or if you add more than 64 bytes of new variables to a function on the call stack.
In some cases, Hot Reload can't apply code changes to the executable immediately, but might be able to apply the code changes later if you continue debugging. This scenario happens if you edit a function that calls the current function or if you add more than 64 bytes of new variables to a function on the call stack.

In such cases, the debugger continues executing the original code until the changes can be applied. The stale code appears as a temporary source file window in a separate source window, with a title such as `enc25.tmp`. The edited source continues to appear in the original source window. If you try to edit the stale code, a warning message appears.

## Related content

- [Supported Code Changes (C++)](../debugger/supported-code-changes-cpp.md)
- [Configure Edit and Continue](../debugger/how-to-enable-and-disable-edit-and-continue.md)
- [Configure Hot Reload](../debugger/how-to-enable-and-disable-edit-and-continue.md)
17 changes: 9 additions & 8 deletions docs/debugger/edit-and-continue-visual-csharp.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Edit and Continue (Visual C#)"
description: Edit and Continue is available for Visual C# projects. Learn what edits are supported, and how to can control whether, and when, your edits are applied.
ms.date: "02/22/2022"
title: "Hot Reload (Visual C#)"
description: Hot Reload (previously called Edit and Continue) is available for Visual C# projects. Learn what edits are supported, and how to control when edits are applied.
ms.date: "03/23/2026"
ms.topic: how-to
dev_langs:
- "CSharp"
Expand All @@ -16,12 +16,13 @@ author: "mikejo5000"
ms.author: "mikejo"
manager: mijacobs
ms.subservice: debug-diagnostics
ms.custom: awp-ai
---
# Edit and Continue (Visual C#)
# Hot Reload (Visual C#)

::: moniker range=">=vs-2022"

With Hot Reload, or Edit and Continue for C#, you can make changes to your code in break or run mode while debugging. The changes can be applied without having to stop and restart the debugging session.
With Hot Reload, previously called Edit and Continue for C#, you can make changes to your code in break or run mode while debugging. The changes can be applied without having to stop and restart the debugging session.

The basic Hot Reload experience works with most types of .NET apps and framework versions. This includes .NET Framework, .NET Core and .NET 5+ (for both C# and Visual Basic as applicable). The expectation in this scenario is that if you’re using the debugger, assume Hot Reload is available to you and give it a try!

Expand Down Expand Up @@ -56,19 +57,19 @@ To enable or disable Hot Reload:

The setting takes effect when you start or restart the debugging session.

To use the classic Edit and Continue experience:
To use the legacy Edit and Continue workflow (Hot Reload in break mode):

1. While debugging, in break mode, make a change to your source code.

1. From the **Debug** menu, select **Continue**, **Step**, or **Set Next Statement**. Debugging continues with the new, compiled code.

Some types of code changes aren't supported by Edit and Continue. For more information, see [Supported code changes (C# and Visual Basic)](../debugger/supported-code-changes-csharp.md).
Some types of code changes aren't supported by Hot Reload. For more information, see [Supported code changes (C# and Visual Basic)](../debugger/supported-code-changes-csharp.md).

::: moniker-end


## Related content

- [Supported Code Changes (C# and Visual Basic)](../debugger/supported-code-changes-csharp.md)
- [Configure Edit and Continue](../debugger/how-to-enable-and-disable-edit-and-continue.md)
- [Configure Hot Reload](../debugger/how-to-enable-and-disable-edit-and-continue.md)
- [Write and debug running XAML code with XAML Hot Reload in Visual Studio](../xaml-tools/xaml-hot-reload.md)
2 changes: 1 addition & 1 deletion docs/debugger/find-your-debugging-task.yml
Original file line number Diff line number Diff line change
Expand Up @@ -193,7 +193,7 @@ sections:

- **Can I edit code during a debugging session?**

Use [Edit and continue](edit-and-continue.md). For XAML, use [XAML Hot Reload](../xaml-tools/xaml-hot-reload.md).
Use [Hot Reload](hot-reload.md), previously called Edit and Continue. For XAML, use [XAML Hot Reload](../xaml-tools/xaml-hot-reload.md).

- **How can I debug on remote machines?**

Expand Down
19 changes: 13 additions & 6 deletions docs/debugger/hot-reload.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Write and debug code by using Hot Reload"
description: Explore the Hot Reload feature, also known as Edit and Continue, and make changes to your code while running applications.
ms.date: 10/02/2025
ms.date: 03/23/2026
ms.topic: how-to
helpviewer_keywords:
- "Hot reload"
Expand All @@ -12,10 +12,12 @@ manager: mijacobs
ms.subservice: debug-diagnostics
monikerRange: '>= vs-2022'
zone_pivot_groups: programming-languages-set-two

ms.custom: awp-ai
---
# Write and debug running code with Hot Reload in Visual Studio (C#, Visual Basic, C++)

Hot Reload was previously known as Edit and Continue in Visual Studio documentation and some legacy UI text.

Starting in Visual Studio 2022, the Hot Reload experience in Visual Studio works for both managed .NET and native C++ apps. Regardless of the type of app you’re working on, the intention of Hot Reload is to save you as many app restarts between edits as possible, making you more productive by reducing the time you spend waiting for apps to rebuild, restart, and re-navigate to the previous location where you were in the app itself.

We improve productivity by making it possible for you to edit your application's code files and apply the code changes immediately to the running application, also known as *Hot Reload*. Once your changes are applied, re-execute your code again by taking an action in the app itself (or through some sort of timer, etc.) and see the changes immediately; no pausing of the app through breakpoints is required!
Expand Down Expand Up @@ -165,7 +167,12 @@ To enable, disable, or configure Hot Reload, see [Configure Edit and Continue](.

If you see the following dialog box, Hot Reload is unable to apply the current edits without restarting. You can choose either to rebuild the app and apply changes (restart) or to continue editing. If you rebuild, all application state is lost. If you continue editing, it's possible that additional changes or corrections might cause Hot Reload to work again.

![Screenshot of the apply changes dialog box](../debugger/media/vs-2022/dotnet-hot-reload-apply-changes.png)
::: moniker range=">=visualstudio"
![Screenshot of the apply changes dialog box.](../debugger/media/visualstudio/dotnet-hot-reload-apply-changes.png)
::: moniker-end
::: moniker range="=vs-2022"
![Screenshot of the apply changes dialog box.](../debugger/media/vs-2022/dotnet-hot-reload-apply-changes.png)
::: moniker-end

If you select the **Always rebuild when changes can't be applied** option in the dialog box, you won't see the dialog box again in the current Visual Studio session, and Visual Studio will automatically rebuild and reload instead of showing the dialog box.

Expand All @@ -179,6 +186,6 @@ If you're using response compression on .NET Core, see the information on [respo

## Related content

* [Edit and Continue (C#)](../debugger/edit-and-continue-visual-csharp.md)
* [Edit and Continue (C++)](../debugger/edit-and-continue-visual-cpp.md)
* [Configure Edit and Continue](../debugger/how-to-enable-and-disable-edit-and-continue.md)
* [Hot Reload (Visual C#)](../debugger/edit-and-continue-visual-csharp.md)
* [Hot Reload (C++)](../debugger/edit-and-continue-visual-cpp.md)
* [Configure Hot Reload](../debugger/how-to-enable-and-disable-edit-and-continue.md)
11 changes: 6 additions & 5 deletions docs/debugger/how-to-enable-and-disable-edit-and-continue.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Configure Edit and Continue
description: Learn how to enable, disable, and configure Edit and Continue, in Visual Studio Options at design time. Edit and Continue works only in debug builds.
ms.date: 10/31/2025
title: Configure Hot Reload
description: Learn how to enable, disable, and configure Hot Reload (previously called Edit and Continue) in Visual Studio options at design time.
ms.date: 03/23/2026
ms.topic: how-to
dev_langs:
- CSharp
Expand All @@ -25,13 +25,14 @@ author: mikejo5000
ms.author: mikejo
manager: mijacobs
ms.subservice: debug-diagnostics
ms.custom: awp-ai
---

# Configure Edit and Continue (C#, VB, C++)
# Configure Hot Reload (C#, VB, C++)

::: moniker range=">=vs-2022"

You can disable or enable Hot Reload, previously called Edit and Continue, from the Visual Studio **Tools** > **Options** menu at design time. **Hot Reload** works only in debug builds. For more information, see [Hot Reload](../debugger/hot-reload.md).
You can disable or enable Hot Reload (previously called Edit and Continue) from the Visual Studio **Tools** > **Options** menu at design time. **Hot Reload** works only in debug builds. For more information, see [Hot Reload](../debugger/hot-reload.md).

For native C++, Hot Reload requires using the `/INCREMENTAL` option. For more information about feature requirements in C++, see this [blog post](https://devblogs.microsoft.com/cppblog/c-edit-and-continue-in-visual-studio-2015-update-3/) and [Edit and Continue (C++)](../debugger/edit-and-continue-visual-cpp.md).

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading