Skip to content

Commit e487145

Browse files
Merge pull request #10623 from MicrosoftDocs/main638750918468111417sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 0ec11c2 + 0c992ba commit e487145

23 files changed

+316
-265
lines changed

.openpublishing.redirection.json

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6206,6 +6206,11 @@
62066206
"redirect_url": "/visualstudio/ide/reference/sync-type-and-file",
62076207
"redirect_document_id": false
62086208
},
6209+
{
6210+
"source_path": "docs/ide/not-in-toc/change-f1-help-key.md",
6211+
"redirect_url": "/visualstudio/ide/not-in-toc/default",
6212+
"redirect_document_id": false
6213+
},
62096214
{
62106215
"source_path": "docs/ide/reference/wrap-align-indent-parameters.md",
62116216
"redirect_url": "/visualstudio/ide/reference/wrap-indent-align-refactorings",
@@ -6241,11 +6246,31 @@
62416246
"redirect_url": "/visualstudio/data-tools/save-data-back-to-the-database",
62426247
"redirect_document_id": false
62436248
},
6249+
{
6250+
"source_path": "docs/debugger/debugging-preparation-windows-forms-applications.md",
6251+
"redirect_url": "/visualstudio/get-started/csharp/tutorial-debugger",
6252+
"redirect_document_id": false
6253+
},
6254+
{
6255+
"source_path": "docs/debugger/debugging-preparation-windows-services.md",
6256+
"redirect_url": "/dotnet/framework/windows-services/how-to-debug-windows-service-applications",
6257+
"redirect_document_id": false
6258+
},
6259+
{
6260+
"source_path": "docs/debugger/edit-and-continue-not-supported-for-f-hash.md",
6261+
"redirect_url": "/visualstudio/debugger/hot-reload",
6262+
"redirect_document_id": false
6263+
},
62446264
{
62456265
"source_path": "docs/debugger/debugger/error-site-uses-ip-address.md",
62466266
"redirect_url": "/previous-versions/visualstudio/visual-studio-2017/debugger/error-site-uses-ip-address",
62476267
"redirect_document_id": false
62486268
},
6269+
{
6270+
"source_path": "docs/debugger/error-site-uses-ip-address.md",
6271+
"redirect_url": "/previous-versions/visualstudio/visual-studio-2017/debugger/error-site-uses-ip-address",
6272+
"redirect_document_id": false
6273+
},
62496274
{
62506275
"source_path": "docs/debugger/error-a-security-check-failed-because-the-iis-admin-service-did-not-respond.md",
62516276
"redirect_url": "/previous-versions/visualstudio/visual-studio-2017/debugger/error-a-security-check-failed-because-the-iis-admin-service-did-not-respond",

docs/debugger/debugging-preparation-console-projects.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ ms.subservice: debug-diagnostics
1919
---
2020
# Debugging Preparation: Console Projects (C#, C++, Visual Basic, F#)
2121

22-
Preparing to debug a Console project is similar to preparing to debug a Windows project, with some additional considerations such as setting command-line arguments and how to pause the app for debugging. For more information, see [Debugging preparation for a Windows Form apps](../debugger/debugging-preparation-windows-forms-applications.md). Because of the similarity of all console applications, this topic covers the following project types:
22+
Preparing to debug a Console project is similar to preparing to debug a Windows project, with some additional considerations such as setting command-line arguments and how to pause the app for debugging. Because of the similarity of all console applications, this topic covers the following project types:
2323

2424
- C#, Visual Basic, and F# Console Application
2525

docs/debugger/debugging-preparation-windows-forms-applications.md

Lines changed: 0 additions & 67 deletions
This file was deleted.

docs/debugger/debugging-preparation-windows-services.md

Lines changed: 0 additions & 28 deletions
This file was deleted.

docs/debugger/edit-and-continue-not-supported-for-f-hash.md

Lines changed: 0 additions & 21 deletions
This file was deleted.

docs/debugger/hot-reload.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ monikerRange: '>= vs-2022'
1414
---
1515
# Write and debug running code with Hot Reload in Visual Studio (C#, Visual Basic, C++)
1616

17-
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, re-navigate to the previous location where you were in the app itself, et al.
17+
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.
1818

1919
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!
2020

@@ -36,9 +36,9 @@ To see the changes in the user interface, the code needs to be re-executed. For
3636

3737
* **When using Visual Studio 2022 and starting your app with the debugger**, the basic Hot Reload experience works with most types of .NET apps and framework versions. This support 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!
3838
* **When using Visual Studio 2022 but not using the debugger** (for example, using CTRL-F5 to start the app), Hot Reload is available when targeting most types of .NET 6 apps. In this scenario, apps not targeting .NET 6+ (that is, they target .NET 5 or below) don't support the "no debugger" scenario and must use the debugger to get Hot Reload support.
39-
* **When using Visual Studio 2022 with a .NET 6+ app, most scenarios are supported**. This support isn't limited to the new "no debugger" feature mentioned above. It also includes other new capabilities, such as support for hot reloading Blazor projects and, more generally, editing Razor files in any ASP.NET Core apps, and CSS Hot Reload. Using Visual Studio 2022 and apps that target .NET 6 together gives you the most powerful Hot Reload experience.
39+
* **When using Visual Studio 2022 with a .NET 6+ app, most scenarios are supported**. This support isn't limited to the new "no debugger" feature mentioned previously. It also includes other new capabilities, such as support for hot reloading Blazor projects and, more generally, editing Razor files in any ASP.NET Core apps, and CSS Hot Reload. Using Visual Studio 2022 and apps that target .NET 6 together gives you the most powerful Hot Reload experience.
4040

41-
The following table shows which projects support .NET Hot Reload with the debugger attached (F5) and without the debugger attached (Ctrl+F5), according to the minimum .NET version required for support in Visual Studio 2022 (17.8).
41+
The following table shows the minimum .NET version required to support .NET Hot Reload with the debugger attached (F5) and without the debugger attached (Ctrl+F5), based on project type. Visual Studio 2022 version 17.8 or later is required.
4242

4343
|Application type|F5|Ctrl+F5|`MetadataUpdateHandler` support|
4444
|-|-|-|-|
@@ -74,13 +74,13 @@ When using Visual Studio 2022 and starting the app with the debugger, Hot Reload
7474
Anywhere you have .NET and you’re using the Visual Studio managed debugger, you should get basic Hot Reload support. This fact means that even projects such as Azure Functions work great in this scenario.
7575

7676
> [!NOTE]
77-
> By default, some projects use mixed mode debugging, which does not support Hot Reload. You can modify this setting in project settings, by setting **Project > Properties > Debug > Open debug launch profiles UI > Enable native code debugging** to false.
77+
> By default, some projects use mixed mode debugging, which doesn't support Hot Reload. You can modify this setting in project settings, by setting **Project > Properties > Debug > Open debug launch profiles UI > Enable native code debugging** to false.
7878
7979
## Visual Studio 2022 with a .NET app, but not using the debugger
8080

8181
Hot Reload is available without the debugger when targeting most types of .NET 6+ apps.
8282

83-
This feature is exclusive to .NET 6+. Those apps not targeting .NET 6+ (that is, they target .NET 5 or below) do not support the "no debugger" scenario and must use the debugger to get access to Hot Reload functionality.
83+
This feature is exclusive to .NET 6+. Those apps not targeting .NET 6+ (that is, they target .NET 5 or below) don't support the "no debugger" scenario and must use the debugger to get access to Hot Reload functionality.
8484

8585
Also, not all project types currently support the "no debugger" scenario, see [Support for .NET applications](#support-for-net-applications).
8686

@@ -121,12 +121,16 @@ Hot Reload isn't available in some project configurations:
121121
* If you’re using the Visual Studio debugger to run your app, but you’ve disabled `Enable Hot Reload and Edit and Continue when debugging` in settings, Hot Reload isn't supported.
122122
* Release or custom build configurations aren't supported. Your project must use the `Debug` build configuration.
123123
* If you're targeting an F# or .NET Native project.
124-
* Some startup or compile optimizations are not supported in .NET Hot Reload. For example, if your project's debug profile is configured in the following ways, .NET Hot Reload isn't supported:
124+
* Some startup or compile optimizations aren't supported in .NET Hot Reload. For example, if your project's debug profile is configured in the following ways, .NET Hot Reload isn't supported:
125125
* [Trimming](/dotnet/core/deploying/trimming/trimming-options) is enabled for your project. For example, it's not supported if `PublishTrimmed` is set to True in your project file for the debug profile.
126126
* [ReadyToRun](/dotnet/core/deploying/ready-to-run) is enabled for your project. For example, it's not supported if `PublishReadyToRun` is set to True in your project file for the debug profile.
127127

128128
See [Unsupported scenarios](../debugger/supported-code-changes-csharp.md#unsupported-scenarios) for more details.
129129

130+
## Hot Reload Not Supported for F# #
131+
132+
Hot Reload, or Edit and Continue, is not supported when you debug F# code. Edits to F# code are possible during a debugging session but should be avoided. Code changes aren't applied during the debugging session. Therefore, any edits made to F# code while you debug will result in source code that doesn't match the code being debugged.
133+
130134
## Configure Hot Reload
131135

132136
To enable, disable, or configure Hot Reload, see [Configure Edit and Continue](../debugger/how-to-enable-and-disable-edit-and-continue.md).
@@ -141,7 +145,7 @@ If you select the **Always rebuild when changes can't be applied** option in the
141145

142146
## Troubleshooting
143147

144-
It is highly recommended to check for the **Hot Reload Output** window for detailed diagnostic information regarding the Hot Reload session.
148+
It's highly recommended to check for the **Hot Reload Output** window for detailed diagnostic information regarding the Hot Reload session.
145149

146150
If you're using response compression on .NET Core, see the information on [response compression](/dotnet/core/tools/dotnet-watch#response-compression).
147151

docs/debugger/toc.yml

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -232,8 +232,6 @@
232232
href: supported-code-changes-csharp.md
233233
- name: Edit and Continue (Visual Basic)
234234
href: edit-and-continue-visual-basic.md
235-
- name: Edit and Continue not supported for F#
236-
href: edit-and-continue-not-supported-for-f-hash.md
237235
- name: XAML Hot Reload
238236
items:
239237
- name: Write and debug running XAML code
@@ -392,14 +390,8 @@
392390
href: how-to-trigger-suspend-resume-and-background-events-for-windows-store-apps-in-visual-studio.md
393391
- name: .NET
394392
items:
395-
- name: Debugging preparation
396-
items:
397-
- name: Recommended property settings
398-
href: managed-debugging-recommended-property-settings.md
399-
- name: 'Debugging preparation: Windows Forms applications'
400-
href: debugging-preparation-windows-forms-applications.md
401-
- name: 'Debugging preparation: Windows services'
402-
href: debugging-preparation-windows-services.md
393+
- name: Recommended property settings
394+
href: managed-debugging-recommended-property-settings.md
403395
- name: Send messages to the Output window
404396
href: diagnostic-messages-in-the-output-window.md
405397
- name: Assertions in managed code

0 commit comments

Comments
 (0)