Debugging, Configuration Properties, <Projectname> Property Pages Dialog Box

Debugging, Configuration Properties, <Projectname> Property Pages Dialog Box

Visual Studio .NET 2003

The Debugging property page in the Configuration Properties folder contains the following properties:

Debuggers Group

Enable ASP Debugging
Enables debugging of Active Server Pages (ASP). This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

See EnableASPDebugging Property for information on how to programmatically access this property.

Enable ASP.NET Debugging
Enables debugging of applications written for the ASP.NET Web development platform.

The debug attribute of the <compilation> tag in the project's web.config file specifies whether debug symbols (.pdb files) will be generated for dynamically compiled ASP.NET files such as .aspx, .asmx, and .ascx.

Because many parts of an ASP.NET application are dynamically compiled at run time, such as .aspx and .ascx files, you must configure the ASP.NET runtime to compile the application with debugging information before these files can be debugged.

To insert debugging information into the compiled page, set debug=true.

Setting debug=true creates a larger file. Therefore, this setting should only be enabled when you are debugging an application, because it can significantly affect the performance of the application.

This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

See EnableASPXDebugging Property for information on how to programmatically access this property.

Enable Unmanaged Debugging
Enables debugging of native (unmanaged) Win32 code called from your Visual C# application. This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

See EnableUnmanagedDebugging Property for information on how to programmatically access this property.

Enable SQL Debugging
Enables debugging of SQL procedures from your Visual C# application. This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

See EnableSQLServerDebugging Property for information on how to programmatically access this property.

Start Action Group

Debug Mode
Specifies whether you want to debug a project, a program, or a URL. You can also select Wait to Attach to an External Process.
  • Project   Indicates that the executable (for Windows Application and Console Application projects) or the page (for Web projects) should be started when the application is debugged. Class Library projects cannot be started directly. If you want to debug an XML Web service, setting this property will cause the application to automatically attach to Internet Explorer.
  • Program   Indicates that a specific program should be started when the application is debugged. For example, you might run a prebuilt client that consumes your Class Library project. You must set Start Application to debug.
  • URL   Indicates that a particular URL (Start URL) should be accessed when the application is debugged. For example, you might access the URL to a Web site that uses your Class Library project.
  • Wait to Attach to an External Process   This value only applies to Web Application and XML Web service projects. For a XML Web service project, the debugger will attach to a process that will call into your XML Web service. Set a breakpoint in your XML Web service before you start so that the breakpoint is hit when the external process calls into your XML Web service.

This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

After changing this property, select the Apply button in order to enable the appropriate property (Start Application, Start URL or Start Page) for editing.

See StartAction Property for information on how to programmatically access this property.

Start Application
Specifies the command for launching the program you are debugging. This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

See StartProgram Property for information on how to programmatically access this property.

Start URL
If Debug Mode is set to URL, specifies the URL where the project you are debugging is located. This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

See StartURL Property for information on how to programmatically access this property.

Start Page
Specifies the URL of a page to be used as the startup page when debugging. This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

See StartPage Property for information on how to programmatically access this property.

Start Options Group

Command Line Arguments
Specifies arguments for the Start Application property. This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

See CommandLineArguments Property for information on how to programmatically access this property.

Working Directory
Specifies the working directory of the program being debugged. This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

See StartWorkingDirectory Property for information on how to programmatically access this property.

Always Use Internet Explorer
Determines whether debugging will use the default Internet browser specified for Visual Studio. This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

See StartWithIE Property for information on how to programmatically access this property.

Enable Remote Debugging
When enabled, allows remote debugging of an .exe on the machine specified in the Remote debug machine property. This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

To access this property programmatically, see RemoteDebugEnabled.

Remote Debug Machine
When Enable remote debugging property is enabled, the name of the machine on which the .exe will run. The location of the .exe on the remote machine must match the value of the Output Path property, which is on the Build property page in the Configuration Properties folder. The remote machine needs the debugger components installed. The user of the local machine needs to be in the Debugger Users group on the remote machine. The .exe must be in a shareable directory on the remote machine.

This property is automatically written and saved to the "per-user" file (.user) for your project whenever you save your project or close it without saving.

To access this property programmatically, see RemoteDebugMachine.

For information on how to access the Debugging property page in the Configuration Properties folder, see Setting Visual C# Project Properties.

Smart Device Developer Notes

Enable ASP Debugging, Enable ASP.NET Debugging, Enable Unmanaged Debugging, Enable SQL Server Debugging, Enable Remote Debugging, and Remote Debugging Machine
Not supported.

See Also

Setting Visual C# Project Properties

Show:
© 2016 Microsoft