Skip to content

Commit 830217a

Browse files
committed
Merging changes synced from https://github.com/MicrosoftDocs/visualstudio-docs-pr (branch live)
2 parents 2513fa0 + 6dc159b commit 830217a

8 files changed

+60
-55
lines changed

docs/code-quality/index.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
### YamlMime:Landing
22

3-
title: Analyze code in Visual Studio
3+
title: Code analysis documentation - Visual Studio (Windows)
44
summary: Visual Studio provides several different tools to analyze and improve code quality.
55

66
metadata:
7-
title: Code analyzers
7+
title: Code analysis documentation - Visual Studio (Windows)
88
description: Learn how Visual Studio can help you analyze code quality.
99
ms.prod: visual-studio-windows
1010
ms.technology: vs-ide-code-analysis

docs/debugger/debugger-feature-tour.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,11 @@ The features described here are applicable to C#, C++, Visual Basic, JavaScript,
2424

2525
Breakpoints are a useful feature when you know the line of code or the section of code that you want to examine in detail at runtime. For more information on the different types of breakpoints, such as conditional breakpoints and function breakpoints, see [Using breakpoints](../debugger/using-breakpoints.md).
2626

27-
To debug, you need to start your app with the debugger attached to the app process. **F5** (**Debug > Start Debugging**) is the most common way to do that. However, right now you may not have set any breakpoints to examine your app code, so we will do that first and then start debugging. Breakpoints are the most basic and essential feature of reliable debugging. A breakpoint indicates where Visual Studio should suspend your running code so you can take a look at the values of variables, or the behavior of memory, or whether or not a branch of code is getting run.
27+
To debug, you need to start your app with the debugger attached to the app process. To do this:
28+
29+
- Press **F5** (**Debug > Start Debugging**), which is the most common method.
30+
31+
However, right now you may not have set any breakpoints to examine your app code, so we will do that first and then start debugging. Breakpoints are the most basic and essential feature of reliable debugging. A breakpoint indicates where Visual Studio should suspend your running code so you can take a look at the values of variables, or the behavior of memory, or whether or not a branch of code is getting run.
2832

2933
If you have a file open in the code editor, you can set a breakpoint by clicking in the margin to the left of a line of code.
3034

docs/debugger/index.yml

Lines changed: 30 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
### YamlMime:Landing
22

3-
title: Visual Studio debugger documentation # < 60 chars
3+
title: Debugger documentation - Visual Studio (Windows) # < 60 chars
44
summary: The Visual Studio debugger helps you observe the run-time behavior of your program and find problems. # < 160 chars
55

66
metadata:
7-
title: Debugging in Visual Studio (Windows) # Required; page title displayed in search results. Include the brand. < 60 chars.
7+
title: Debugger documentation - Visual Studio (Windows) # Required; page title displayed in search results. Include the brand. < 60 chars.
88
titleSuffix: ""
99
description: Learn how to use Visual Studio to debug applications and code.
1010
ms.topic: landing-page
@@ -21,57 +21,42 @@ landingContent:
2121
# Start card title with a verb
2222
# Card (optional)
2323
- title: Get started
24-
linkLists:
25-
- linkListType: tutorial
26-
links:
27-
- text: Learn to debug C#
28-
url: ../get-started/csharp/tutorial-debugger.md?toc=%252fvisualstudio%252fdebugger%252ftoc.json
29-
- text: Learn to debug C++
30-
url: getting-started-with-the-debugger-cpp.md
31-
- text: Learn to debug Visual Basic
32-
url: ../get-started/visual-basic/tutorial-debugger.md?toc=%252fvisualstudio%252fdebugger%252ftoc.json
33-
- text: Run Python code in the debugger >>
34-
url: ../python/tutorial-working-with-python-in-visual-studio-step-04-debugging.md
35-
- linkListType: how-to-guide
36-
links:
37-
- text: Debugging for absolute beginners
38-
url: debugging-absolute-beginners.md
39-
40-
# Card (optional)
41-
- title: Fundamentals
4224
linkLists:
4325
- linkListType: overview
4426
links:
4527
- text: First look at the debugger
4628
url: debugger-feature-tour.md
4729
- text: What is debugging?
4830
url: what-is-debugging.md
49-
- text: FAQ - Find your debugging feature
50-
url: find-your-debugging-task.yml
51-
52-
# Card
53-
- title: Use the debugger
54-
linkLists:
5531
- linkListType: how-to-guide
5632
links:
33+
- text: Start the debugger
34+
url: debugger-feature-tour.md#set-a-breakpoint-and-start-the-debugger
5735
- text: Code stepping
5836
url: navigating-through-code-with-the-debugger.md
59-
- text: Breakpoints
37+
- text: Set a breakpoint
6038
url: using-breakpoints.md
6139
- text: Edit code and continue debugging
6240
url: edit-and-continue.md
6341
- text: Call stack
6442
url: how-to-use-the-call-stack-window.md
43+
- linkListType: tutorial
44+
links:
45+
- text: Debugging for absolute beginners
46+
url: debugging-absolute-beginners.md
6547

66-
# Card
67-
- title: Inspect data
48+
- title: Tutorials
6849
linkLists:
69-
- linkListType: how-to-guide
50+
- linkListType: tutorial
7051
links:
71-
- text: Inspect variables
72-
url: autos-and-locals-windows.md
73-
- text: Set a watch on variables
74-
url: watch-and-quickwatch-windows.md
52+
- text: Learn to debug C#
53+
url: ../get-started/csharp/tutorial-debugger.md?toc=%252fvisualstudio%252fdebugger%252ftoc.json
54+
- text: Learn to debug C++
55+
url: getting-started-with-the-debugger-cpp.md
56+
- text: Learn to debug Visual Basic
57+
url: ../get-started/visual-basic/tutorial-debugger.md?toc=%252fvisualstudio%252fdebugger%252ftoc.json
58+
- text: Run Python code in the debugger >>
59+
url: ../python/tutorial-working-with-python-in-visual-studio-step-04-debugging.md
7560

7661
# Card
7762
- title: Go deeper with the debugger
@@ -94,4 +79,14 @@ landingContent:
9479
- linkListType: tutorial
9580
links:
9681
- text: Write and debug code with Live Share >>
97-
url: /visualstudio/liveshare/use/vs
82+
url: /visualstudio/liveshare/use/vs
83+
84+
# Card
85+
- title: Inspect data
86+
linkLists:
87+
- linkListType: how-to-guide
88+
links:
89+
- text: Inspect variables
90+
url: autos-and-locals-windows.md
91+
- text: Set a watch on variables
92+
url: watch-and-quickwatch-windows.md

docs/debugger/navigating-through-code-with-the-debugger.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ ms.workload:
2121

2222
[!INCLUDE [Visual Studio](~/includes/applies-to-version/vs-windows-only.md)]
2323

24-
The Visual Studio debugger can help you navigate through code to inspect the state of an app and show its execution flow. You can use keyboard shortcuts, debug commands, breakpoints, and other features to quickly get to the code you want to examine. If you're familiar with debugger navigation commands and shortcuts, you can find and resolve app problems faster and more easily.
24+
The Visual Studio debugger can help you navigate through code to inspect the state of an app and show its execution flow, which is also known as *code stepping*. You can use keyboard shortcuts, debug commands, breakpoints, and other features to quickly get to the code you want to examine. If you're familiar with debugger navigation commands and shortcuts, you can find and resolve app problems faster and more easily.
2525

2626
> [!NOTE]
2727
> If you're new to debugging code, you might want to read [Debugging for absolute beginners](../debugger/debugging-absolute-beginners.md) and [Debugging techniques and tools](../debugger/write-better-code-with-visual-studio.md) before you read this article.

docs/debugger/remote-debugging-aspnet-on-a-remote-iis-7-5-computer.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -53,9 +53,7 @@ This article includes steps on setting up a basic configuration of IIS on Window
5353

5454
1. Create a new MVC ASP.NET application.
5555

56-
::: moniker range=">=vs-2019"
57-
In Visual Studio 2019, type **Ctrl + Q** to open the search box, type **asp.net**, choose **Templates**, then choose **Create new ASP.NET Web Application (.NET Framework)**. In the dialog box that appears, name the project **MyASPApp**, and then choose **Create**. Select **MVC** and choose **Create**.
58-
::: moniker-end
56+
In Visual Studio, choose **File** > **Start window** to open the Start window, and then choose **Create a new project**. In the search box, type **asp.net framework**, and then choose **ASP.NET Web Application (.NET Framework)**. In the dialog box that appears, name the project **MyASPApp**, choose **ASP.NET Framework 4.8**, and then choose **Create**.
5957

6058
Select **MVC** and choose **Create**.
6159

@@ -83,16 +81,18 @@ If you want more detailed information to install ASP.NET on IIS, see [IIS 8.0 Us
8381
> [!NOTE]
8482
> The Web Platform Installer reached End-of-Life on 7/1/22. For more information, see [Web Platform Installer - End of support and sunsetting the product/application feed](https://blogs.iis.net/iisteam/web-platform-installer-end-of-support-feed). You can directly install ASP.NET 4.8 from IIS.
8583
86-
1. Use the Web Platform Installer (WebPI) to install ASP.NET 4.5 (from the Server node in Windows Server 2012 R2, choose **Get New Web Platform Components** and then search for ASP.NET)
84+
1. In the left pane of Server Manager, select **IIS**. Right-click the server and select **Add Roles and Features**.
85+
86+
1. In the wizard, advance to the **Features** section and install ASP.NET 4.8.
8787

88-
![Screenshot of the Web Platform Installer 5.0 showing the search results for asp.net with the web platform component IIS: ASP.NET 4.5 circled in red.](../debugger/media/remotedbg_iis_aspnet_45.png)
88+
![Screenshot of IIS Add roles and features for IIS: ASP.NET 4.8 selected.](../debugger/media/remote-debug-iis-asp-dotnet-48.png)
8989

9090
> [!NOTE]
9191
> If you are using Windows Server 2008 R2, install ASP.NET 4 instead using this command:
9292
9393
**C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir**
9494

95-
2. Restart the system (or execute **net stop was /y** followed by **net start w3svc** from a command prompt to pick up a change to the system PATH).
95+
1. Restart the system (or execute **net stop was /y** followed by **net start w3svc** from a command prompt to pick up a change to the system PATH).
9696

9797
## Choose a deployment option
9898

@@ -125,7 +125,11 @@ After the app deploys successfully, it should start automatically. If the app do
125125

126126
1. Switch to a debug configuration.
127127

128-
::: moniker range=">=vs-2019"
128+
::: moniker range=">=vs-2022"
129+
Choose **More Options** > **Edit** to edit the profile, and then choose **Settings**. Choose a **Debug** configuration, and then choose **Remove additional files at destination** under the **File Publish** options.
130+
::: moniker-end
131+
132+
::: moniker range="vs-2019"
129133
Choose **Edit** to edit the profile, and then choose **Settings**. Choose a **Debug** configuration, and then choose **Remove additional files at destination** under the **File Publish** options.
130134
::: moniker-end
131135

docs/debugger/remote-debugging-aspnet-on-a-remote-iis-computer.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -48,13 +48,11 @@ This article includes steps on setting up a basic configuration of IIS on Window
4848

4949
1. Create a new ASP.NET Core web application.
5050

51-
::: moniker range=">=vs-2019"
52-
In Visual Studio 2019, choose **Create a new project** in the start window. If the start window is not open, choose **File** > **Start Window**. Type **web app**, choose **C#** as the language, then choose **ASP.NET Core Web Application (Model-View-Controller)**, and then choose **Next**. On the next screen, name the project **MyASPApp**, and then choose **Next**.
51+
In Visual Studio, choose **File** > **Start window** to open the Start window, and then choose **Create a new project**. In the search box, type **web app**, then choose **C#** as the language, then choose **ASP.NET Core Web Application (Model-View-Controller)**, and then choose **Next**. On the next screen, name the project **MyASPApp**, and then choose **Next**.
5352

5453
Choose either the recommended target framework or .NET 6, and then choose **Create**.
55-
::: moniker-end
5654

57-
4. Open the About.cshtml.cs file and set a breakpoint in the `OnGet` method (in older templates, open HomeController.cs instead and set the breakpoint in the `About()` method).
55+
2. Open the About.cshtml.cs file and set a breakpoint in the `OnGet` method (in older templates, open HomeController.cs instead and set the breakpoint in the `About()` method).
5856

5957
## <a name="bkmk_configureIIS"></a> Install and Configure IIS on Windows Server
6058

@@ -120,7 +118,11 @@ After the app deploys successfully, it should start automatically. If the app do
120118

121119
1. Switch to a debug configuration.
122120

123-
::: moniker range=">=vs-2019"
121+
::: moniker range=">=vs-2022"
122+
Choose **More Options** > **Edit** to edit the profile, and then choose **Settings**. Choose a **Debug** configuration, and then choose **Remove additional files at destination** under the **File Publish** options.
123+
::: moniker-end
124+
125+
::: moniker range="vs-2019"
124126
Choose **Edit** to edit the profile, and then choose **Settings**. Choose a **Debug** configuration, and then choose **Remove additional files at destination** under the **File Publish** options.
125127
::: moniker-end
126128

docs/debugger/remote-debugging-azure.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -60,11 +60,9 @@ This article includes steps on setting up a basic configuration of IIS on Window
6060

6161
1. Create a new ASP.NET Core web application.
6262

63-
::: moniker range=">=vs-2019"
64-
In Visual Studio 2019, choose **Create a new project** in the start window. If the start window is not open, choose **File** > **Start Window**. Type **web app**, choose **C#** as the language, then choose **ASP.NET Core Web Application (Model-View-Controller)**, and then choose **Next**. On the next screen, name the project **MyASPApp**, and then choose **Next**.
63+
In Visual Studio, choose **File** > **Start window** to open the Start window, and then choose **Create a new project**. In the search box, type **web app**, then choose **C#** as the language, then choose **ASP.NET Core Web Application (Model-View-Controller)**, and then choose **Next**. On the next screen, name the project **MyASPApp**, and then choose **Next**.
6564

6665
Choose either the recommended target framework or .NET 6, and then choose **Create**.
67-
::: moniker-end
6866

6967
1. Open the About.cshtml.cs file and set a breakpoint in the `OnGet` method (in older templates, open HomeController.cs instead and set the breakpoint in the `About()` method).
7068

docs/debugger/using-breakpoints.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,9 @@ Breakpoints are one of the most important debugging techniques in your developer
4949

5050
You can set a breakpoint on any line of executable code. For example, in the following C# code, you could set a breakpoint on the line of code with the variable assignment (`int testInt = 1`), the `for` loop, or any code inside the `for` loop. You can't set a breakpoint on method signatures, declarations for a namespace or class, or variable declarations if there's no assignment and no getter/setter.
5151

52-
To set a breakpoint in source code, click in the far left margin next to a line of code. You can also select the line and press **F9**, select **Debug** > **Toggle Breakpoint**, or right-click and select **Breakpoint** > **Insert breakpoint**. The breakpoint appears as a red dot in the left margin.
52+
To set a breakpoint in source code:
53+
54+
- Click in the far left margin next to a line of code. You can also select the line and press **F9**, select **Debug** > **Toggle Breakpoint**, or right-click and select **Breakpoint** > **Insert breakpoint**. The breakpoint appears as a red dot in the left margin.
5355

5456
For most languages including C#, breakpoint and current execution lines are automatically highlighted. For C++ code, you can turn on highlighting of breakpoint and current lines by selecting **Tools** (or **Debug**) > **Options** > **Debugging** > **Highlight entire source line for breakpoints and current statement (C++ only)**.
5557

0 commit comments

Comments
 (0)