Skip to content

Commit d12509f

Browse files
authored
Merge pull request #409 from Microsoft/mikejo-updates
content refresh updates
2 parents b01ab82 + e67289c commit d12509f

24 files changed

+137
-335
lines changed

docs/debugger/TOC.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -51,9 +51,7 @@
5151
### [Debug DLL Projects](debugging-dll-projects.md)
5252
#### [How to: Debug from a DLL Project](how-to-debug-from-a-dll-project.md)
5353
#### [How to: Debug in Mixed Mode](how-to-debug-in-mixed-mode.md)
54-
#### [Web Control Library (Managed Code)](web-control-library-managed-code.md)
5554
### [Debugging Preparation: Console Projects](debugging-preparation-console-projects.md)
56-
### [Debugging Preparation: ASP.NET Web Applications](debugging-preparation-aspnet-web-applications.md)
5755
### [How to: Debug an Executable Not Part of a Visual Studio Solution](how-to-debug-an-executable-not-part-of-a-visual-studio-solution.md)
5856
### [How to: Debug with Code Center Premium Source](how-to-debug-with-code-center-premium-source.md)
5957
### [Debugging and the Hosting Process](debugging-and-the-hosting-process.md)
@@ -233,7 +231,6 @@
233231
#### [How to: Debug an ActiveX Control](how-to-debug-an-activex-control.md)
234232
##### [Debug a Data-Bound ActiveX Control](debugging-a-data-bound-activex-control.md)
235233
#### [COM Debugging Tools](com-debugging-tools.md)
236-
### [How to: Debug Native DLLs](how-to-debug-native-dlls.md)
237234
### [How to: Debug Injected Code](how-to-debug-injected-code.md)
238235
## [Debug GPU Code](debugging-gpu-code.md)
239236
## [Graphics Diagnostics](graphics/TOC.md)

docs/debugger/debugger-settings-and-preparation.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,10 +52,7 @@ This section describes the debugger-related property settings, and the preparati
5252
Describes recommended project settings for debugging DLL projects, how to debug from a DLL project, how debug in mixed mode, and how to debug a managed-code Web Control Library.
5353

5454
[Console Projects](../debugger/debugging-preparation-console-projects.md)
55-
Provides instructions on how to configure console projects for debugging.
56-
57-
[ASP.NET Web Applications](../debugger/debugging-preparation-aspnet-web-applications.md)
58-
Provides instructions on how to configure ASP.NET Web applications.
55+
Provides instructions on how to configure console projects for debugging.
5956

6057
[How to: Debug an Executable Not Part of a Visual Studio Solution](../debugger/how-to-debug-an-executable-not-part-of-a-visual-studio-solution.md)
6158
Explains how to debug an executable that is not created as part of a Visual Studio project.

docs/debugger/debugging-dll-projects.md

Lines changed: 5 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Debugging DLL Projects | Microsoft Docs"
33
ms.custom: ""
4-
ms.date: "11/04/2016"
4+
ms.date: "04/11/2017"
55
ms.reviewer: ""
66
ms.suite: ""
77
ms.technology:
@@ -44,45 +44,14 @@ The following templates create DLLs:
4444

4545
- (C++, C#, and Visual Basic) Class Library
4646

47-
- (C++, C#, and Visual Basic): Windows Forms Control Library
47+
- (C++, C#, and Visual Basic): Windows Forms Control Library
4848

4949
Debugging a Windows Control Library is similar to debugging a Class Library project. In most cases, you will call the Windows control from another project. When you debug the calling project, you can step into the code of your Windows control, set breakpoints, and perform other debugging operations. For more information, see [Windows Forms Controls](http://msdn.microsoft.com/Library/f050de8f-4ebd-4042-94b8-edf9a1dbd52a).
50-
51-
- (C# and Visual Basic): Web Control Library
52-
53-
For more information, see [Web Control Library (Managed Code)](../debugger/web-control-library-managed-code.md).
54-
55-
- (C++): MFC ActiveX Control and MFC Smart Device ActiveX Control
56-
57-
ActiveX controls are controls that can be downloaded over the Internet onto a client computer, and displayed and activated on Web pages.
58-
59-
Debugging ActiveX controls is similar to debugging other kinds of controls because they cannot be run as stand-alone, but must be embedded in an HTML Web page. For more information, see [How to: Debug an ActiveX Control](../debugger/how-to-debug-an-activex-control.md).
60-
61-
- (C++): MFC Smart Device DLL
50+
51+
- (C++): Win32 Console DLL project
6252

6353
For more information, see [MFC Debugging Techniques](../debugger/mfc-debugging-techniques.md).
64-
65-
This section also contains information about the following topics:
66-
67-
- [How to: Debug from a DLL Project](../debugger/how-to-debug-from-a-dll-project.md)
68-
69-
- [How to: Debug in Mixed Mode](../debugger/how-to-debug-in-mixed-mode.md)
70-
71-
This topic contains the following sections, which provide considerations about how to prepare to debug class libraries:
72-
73-
- [Building a Debug Version](#vxtskdebuggingdllprojectsbuildingadebugversion)
74-
75-
- [Mixed-Mode Debugging](#vxtskdebuggingdllprojectsmixedmodedebugging)
76-
77-
- [Changing Default Configurations](#vxtskdebuggingdllprojectschangingdefaultconfigurations)
78-
79-
- [Ways to Debug the DLL](#vxtskdebuggingdllprojectswaystodebugthedll)
80-
81-
- [The Calling Application](#vxtskdebuggingdllprojectsthecallingapplication)
82-
83-
- [Controls on a Web Page](#vxtskdebuggingdllprojectscontrolsonawebpage)
84-
85-
- [The Immediate Window](#vxtskdebuggingdllprojectstheimmediatewindow)
54+
8655

8756
## <a name="vxtskdebuggingdllprojectsbuildingadebugversion"></a> Building a Debug Version
8857
No matter how you start debugging, make sure that you build the Debug version of the DLL first and make sure that the Debug version is in the location where the application expects to find it. This may seem obvious, but if you forget this step, the application might find a different version of the DLL and load it. The program will then continue to run, while you wonder why your breakpoint was never hit. When you are debugging, you can verify which DLLs your program has loaded by opening the debugger's **Modules** window. The **Modules** window lists each DLL or EXE loaded in the process you are debugging. For more information, see [How to: Use the Modules Window](../debugger/how-to-use-the-modules-window.md).
@@ -119,11 +88,6 @@ The following templates create DLLs:
11988

12089
Before you start debugging the calling application, you will usually want to set a breakpoint in the class library. For more information, see [Breakpoints and Tracepoints](http://msdn.microsoft.com/en-us/fe4eedc1-71aa-4928-962f-0912c334d583). When the breakpoint is hit, you can step through the code, observing the action at each line, until you isolate the problem. For more information, see [Code Stepping Overview](http://msdn.microsoft.com/en-us/8791dac9-64d1-4bb9-b59e-8d59af1833f9).
12190

122-
### <a name="vxtskdebuggingdllprojectscontrolsonawebpage"></a> Controls on a Web Page
123-
To debug a Web page control, create an [!INCLUDE[vstecasp](../code-quality/includes/vstecasp_md.md)] page that embeds it if such a page does not already exist. You then place breakpoints in the Web page code as well as the control code. You then invoke the Web page from [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)].
124-
125-
Before you start debugging the calling application, you will usually want to set a breakpoint in the DLL. When the breakpoint is hit, you can step through the code, observing the action at each line, until you isolate the problem. For more information, see [Breakpoints and Tracepoints](http://msdn.microsoft.com/en-us/fe4eedc1-71aa-4928-962f-0912c334d583).
126-
12791
### <a name="vxtskdebuggingdllprojectstheimmediatewindow"></a> The Immediate Window
12892
You can evaluate functions or methods in the DLL without having a calling application. You do design-time debugging and you use the **Immediate** window. To debug in this manner, do the follow these steps while the DLL project is open:
12993

docs/debugger/debugging-native-code.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Debugging Native Code | Microsoft Docs"
33
ms.custom: ""
4-
ms.date: "11/04/2016"
4+
ms.date: "04/11/2017"
55
ms.reviewer: ""
66
ms.suite: ""
77
ms.technology:
@@ -68,9 +68,6 @@ The section covers some common debugging problems and techniques for native appl
6868
[COM and ActiveX Debugging](../debugger/com-and-activex-debugging.md)
6969
Provides information on debugging COM and ActiveX applications, including tools you can use for COM and ActiveX debugging.
7070

71-
[How to: Debug Native DLLs](../debugger/how-to-debug-native-dlls.md)
72-
Explains how to set up debugging for DLLs from native code.
73-
7471
[How to: Debug Injected Code](../debugger/how-to-debug-injected-code.md)
7572
Provides guidance on debugging code that uses attributes. Instructions include how to turn on Source Annotation, how to view injected code, and how to view the disassembly code at the current execution point.
7673

@@ -80,6 +77,9 @@ The section covers some common debugging problems and techniques for native appl
8077
## Related Sections
8178
[Visual C++ Project Types](../debugger/debugging-preparation-visual-cpp-project-types.md)
8279
Provides links to topics that describe how to debug the native project types created by the Visual C++ project templates.
80+
81+
[Debugging DLL Projects](../debugger/debugging-dll-projects.md)
82+
Provides information on how to debug native and managed DLLs.
8383

8484
[Debugging in Visual Studio](../debugger/debugging-in-visual-studio.md)
8585
Provides links to the larger sections of the debugging documentation. Information includes what's new in the debugger, settings and preparation, breakpoints, handling exceptions, edit and continue, debugging managed code, debugging native code, debugging SQL, and the user interface references.

docs/debugger/debugging-preparation-aspnet-web-applications.md

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

docs/debugger/debugging-web-applications-and-script.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -56,10 +56,7 @@ Table legend:
5656
[Walkthrough: Debugging a Parallel Application](../debugger/walkthrough-debugging-a-parallel-application.md)
5757
Describes how to use the **Parallel Tasks** and **Parallel Stacks** tool windows to debug a parallel application.
5858

59-
## Related Sections
60-
[ASP.NET Web Applications](../debugger/debugging-preparation-aspnet-web-applications.md)
61-
Describes the default project settings and behavior of [!INCLUDE[vstecasp](../code-quality/includes/vstecasp_md.md)] Web application projects, steps for debugging, and changing the default Debug configuration.
62-
59+
## Related Sections
6360
[Debugging in Visual Studio](../debugger/debugging-in-visual-studio.md)
6461
Provides links to the larger sections of the debugging documentation. Information includes the following: what's new in the debugger, settings and preparation, breakpoints, handling exceptions, edit and continue, debugging managed code, debugging [!INCLUDE[vcprvc](../code-quality/includes/vcprvc_md.md)] projects, debugging COM and ActiveX, debugging DLLs, debugging SQL, and the user interface references.
6562

docs/debugger/executable-for-debugging-session-dialog-box.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ This dialog box appears when you try to debug a DLL for which no executable is s
4949
**URL where the project can be accessed (ATL Server only)**
5050
If you are debugging an ATL Server DLL, enter the URL where the project can be found.
5151

52-
Once entered, these settings are stored in the project Property Pages, so you will not need to enter them again for subsequent debugging sessions. If you need to change the settings, you can open the Property Pages and change the values. For more information on specifying a executable for the debugging session, see [Debugging DLLs](../debugger/how-to-debug-native-dlls.md).
52+
Once entered, these settings are stored in the project Property Pages, so you will not need to enter them again for subsequent debugging sessions. If you need to change the settings, you can open the Property Pages and change the values. For more information on specifying a executable for the debugging session, see [Debugging DLLs](../debugger/how-to-debug-from-a-dll-project.md).
5353

5454
## See Also
5555
[Debugging in Visual Studio](../debugger/debugging-in-visual-studio.md)

docs/debugger/how-to-debug-an-executable-not-part-of-a-visual-studio-solution.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "How to: Debug an Executable Not Part of a Visual Studio Solution | Microsoft Docs"
2+
title: "How to: Debug an executable that is not part of a Visual Studio solution | Microsoft Docs"
33
ms.custom: ""
44
ms.date: "11/04/2016"
55
ms.reviewer: ""
@@ -38,12 +38,17 @@ translation.priority.ht:
3838
- "zh-cn"
3939
- "zh-tw"
4040
---
41-
# How to: Debug an Executable Not Part of a Visual Studio Solution
41+
# How to: Debug an executable that is not part of a Visual Studio solution
4242
Sometimes, you may want to debug an executable that is not part of a [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] project. It may be an executable you created outside of [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] or an executable you received from someone else.
4343

44-
The usual answer to this problem is to start the executable outside of Visual Studio and attach to it using the [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] debugger. For more information, see[Attach to Running Processes](../debugger/attach-to-running-processes-with-the-visual-studio-debugger.md).
44+
The usual answer to this problem is to start the executable outside of Visual Studio and attach to it using the [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] debugger. For more information, see [Attach to Running Processes](../debugger/attach-to-running-processes-with-the-visual-studio-debugger.md).
4545

46-
Attaching to an application requires some manual steps, so it takes a few seconds. This slight delay means that attaching will not help if you are trying to debug a problem that occurs during startup. Also, if you are debugging a program that does not wait for user input and finishes quickly, you may not have time to attach to it. If you have [!INCLUDE[vcprvc](../code-quality/includes/vcprvc_md.md)] installed, you can create an EXE project for such a program.
46+
Attaching to an application requires some manual steps, so it takes a few seconds. This slight delay means that attaching will not help if you are trying to debug a problem that occurs during startup. Also, if you are debugging a program that does not wait for user input and finishes quickly, you may not have time to attach to it. If you have [!INCLUDE[vcprvc](../code-quality/includes/vcprvc_md.md)] installed, you can create an EXE project for such a program.
47+
48+
> [!NOTE]
49+
> Not all programming languages support EXE projects. Install [!INCLUDE[vcprvc](../code-quality/includes/vcprvc_md.md)] if you need to use this feature.
50+
51+
When you are debugging an executable without the source code, the available debugging features are limited, whether you attach to a running executable or add the executable to a [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] solution. Also, if the executable was built without [debug information](../debugger/how-to-set-debug-and-release-configurations.md) in a compatible format, available features are further limited. If you have the source code, the best approach is to import the source code into [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] and create a debug build of the executable in [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)].
4752

4853
### To create an EXE project for an existing executable
4954

@@ -52,8 +57,10 @@ Sometimes, you may want to debug an executable that is not part of a [!INCLUDE[v
5257
2. In the **Open Project** dialog box, click the drop-down list next to the **File name** box, and select **All Project Files**.
5358

5459
3. Locate the executable, and click **OK**.
55-
56-
This creates a temporary solution that contains the executable.
60+
61+
This creates a temporary solution that contains the executable.
62+
63+
5. Start the executable by choosing an execution command, such as **Start**, from the **Debug** menu.
5764

5865
### To import an executable into a Visual Studio solution
5966

@@ -65,12 +72,7 @@ Sometimes, you may want to debug an executable that is not part of a [!INCLUDE[v
6572

6673
4. Click **OK**.
6774

68-
5. Start the executable by choosing an execution command, such as **Start**, from the **Debug** menu.
69-
70-
> [!NOTE]
71-
> Not all programming languages support EXE projects. Install [!INCLUDE[vcprvc](../code-quality/includes/vcprvc_md.md)] if you need to use this feature.
72-
73-
When you are debugging an executable without the source code, the available debugging features are limited, whether you attach to a running executable or add the executable to a [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] solution. If the executable was built without debug information in a compatible format, available features are further limited. If you have the source code, the best approach is to import the source code into [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] and create a debug build of the executable in [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)].
75+
5. Start the executable by choosing an execution command, such as **Start**, from the **Debug** menu.
7476

7577
## See Also
7678
[Debugger Settings and Preparation](../debugger/debugger-settings-and-preparation.md)

0 commit comments

Comments
 (0)