EnvDTE90a

Contains the properties and methods that are used to programmatically control a breakpoint. To use , you must add a reference to EnvDTE90a.dll. For native development, you must add a reference to dte90a.tlb.

Gets the address that a breakpoint is bound to.

For native code, contains a hexadecimal string representation of the breakpoint memory address. For example, 0x5699341.For managed code, contains a metadata-defined function followed by an IL offset. For example, MyApplication.MyFunc+0x000003.Contains an error code if the breakpoint is not bound.

Gets or sets a value that indicates whether the program breaks when a breakpoint is encountered.

Gets a collection of all child objects.

A collection.

Gets the collection that contains all the objects.

A collection.

Gets the condition that triggers a breakpoint.

A string that contains the condition that triggers the breakpoint.

Gets the condition type of the breakpoint, which can be either break when true, or break when it is changed.

One of the values.

Gets the number of times this breakpoint has been hit during this debugging session.

An integer that contains the number of times a breakpoint is hit during the debugging session.

Deletes the breakpoint.

Gets the top-level extensibility object.

A object.

Sets or returns the enabled state of the breakpoint.

A Boolean value that is true if the breakpoint is enabled, otherwise false.

Gets the name of the file in which the breakpoint is contained.

A string that contains the name of the file in which the breakpoint is contained.

Gets the character location within a line in a file where the breakpoint is set.

An integer that contains the character location.

Gets the line within a file where the breakpoint is set.

An integer that contains the source-code line number at which the breakpoint is set.

Gets or sets a condition at which a breakpoint is set.

A string that contains a condition at which a breakpoint is set.

Gets the column offset from the name of a function breakpoint.

An integer that contains the column offset from the name of a function breakpoint.

Gets the line offset from the name of a function breakpoint.

An integer that contains the line offset from the name of a function breakpoint.

Gets the name of the function that contains the breakpoint.

A string that contains the function name.

Gets the hit count target for any type of breakpoint. It is interpreted based on the hit count type.

An integer that contains the hit count target for any type of breakpoint.

Gets the hit count type, which describes how to interpret a hit count.

One of the values.

Gets the name of the programming language that contains the breakpoint.

A string that contains the name of the programming language.

Gets the location type the breakpoint represents.

One of the values.

Gets or sets a breakpoint macro.

A string that contains a breakpoint macro.

Gets or sets a breakpoint message.

A string that contains a breakpoint message.

Sets or returns the name of the breakpoint.

A string that contains the name of the breakpoint.

Gets the immediate parent object of the breakpoint.

The collection.

Gets the process in which the breakpoint is set.

A object.

Gets the executable being managed by this process.

A object.

Resets the breakpoint hit count.

Sets or gets a user-defined string that identifyies this breakpoint.

A string that contains the breakpoint tag.

Gets a constant that specifies the type of breakpoint.

One of the values.

is used to interrogate and manipulate the state of the debugger and the program being debugged. supersedes the interfaces.

Gets a collection of bound breakpoints that were last simultaneously hit.

A collection.

Causes the given process to pause its execution so that its current state can be analyzed.

Set to true to return only when the debugger has entered break mode. Set to false to break and return immediately. See How to: Break Execution for more information.

Gets the last breakpoint hit. To get a collection of multiple breakpoints hit simultaneously, see .

A object.

Gets a collection of breakpoints.

A collection.

Gets the current mode of the debugger within the context of the IDE.

A value.

Gets or sets the active process.

A object.

Sets or returns the active program.

A object.

Gets or sets the current stack frame.

A object.

Gets or sets the current thread being debugged.

A object.

Gets the list of processes that are currently being debugged.

A collection.

Detaches from all attached programs.

Gets the top-level extensibility object.

A object.

Gets the exception settings for the debugger. For each exception, these settings determine whether the debugger gives the code a chance to handle the exception before the debugger breaks execution.

A object.

Executes the specified statement. If the flag is true, then the string is interpreted as an expression, and output is sent to the Command Window.

The statement to execute. The timeout period, in milliseconds. true if the string is to be interpreted as an expression; otherwise false.

Gets or sets a value that determines whether the debugger breaks or continues when a tracepoint or breakpoint finishes executing a macro. The default behavior is set by the user in the dialog box when the tracepoint or breakpoint is created. This property can be used to change the default behavior.

A Boolean that is true if continuation will be forced; otherwise, false.

Evaluates an expression based on the current stack frame. If the expression can be parsed but not evaluated, an object is returned but does not contain a valid value.

An . The expression text to be evaluated. true if the auto-expand rules should be used; otherwise, false. The timeout period in milliseconds.

Evaluates an expression based on the current stack frame. If the expression can be parsed but not evaluated, an object is returned but does not contain a valid value. This method is similar to but with an additional Boolean parameter, which can be set to true to indicate that the expression is to be evaluated as a statement.

An . The expression text to be evaluated. true if the auto-expand rules should be used; otherwise, false. true if the expression text should be treated as a single statement; otherwise, false. The timeout period in milliseconds.

Evaluates an expression, similar to . However, this method allows the caller to specify the stack frame that the evaluation will occur on. It also allows the caller to specify whether automatic evaluation of properties and implicit function calls should occur.

An . The expression text to be evaluated. The stack frame where the expression is to be evaluated. This stack frame can be in any thread of any process that is currently being debugged, if and only if the process is in break mode. true if the auto-expand rules should be used; otherwise, false. true if the expression text should be treated as a single statement; otherwise, false. true if automatic evaluation of properties and implicit function calls should be performed; otherwise, false. The timeout period in milliseconds.

Gets an object that represents the processes that are currently connected for debugging on the specified transport.

. A transport type or protocol that is used by the debugger to communicate with the computer that is running the process being debugged. See . A qualifier for the transport type. See .

Starts executing the program from the current statement.

Set to true if this function call should wait until either Break mode or Design mode is entered before returning. Set to false if you want this call to return immediately after causing the debugger to begin execution. Upon return, the debugger could be in Design, Break, or Run modes. See Execution Control for more information.

Gets or sets a value that indicates whether the expressions are output in hexadecimal or decimal format.

A Boolean that is true if hexadecimal format; otherwise, false.

Gets or sets a value that indicates whether the expressions are evaluated in hexadecimal or decimal format.

A Boolean that is true if hexadecimal format; otherwise, false.

Gets a list of languages that the debugger supports.

A collection.

Gets the last reason that a program was broken. If the program is running, it returns DBG_REASON_NONE.

A value.

Gets the list of processes that are currently running on this computer.

A collection.

Gets a value that determines whether symbols are loaded manually or automatically. The Visual Studio user can determine this setting in the Options dialog box. For more information about how to set this value within Visual Studio, see [OBSOLETE] How to: Specify Symbol Locations and Loading Behavior.

A Boolean that is true if symbols must be loaded manually; false if symbols are loaded automatically.

Gets the immediate parent object of the object ().

A object.

Executes the program to the current position of the source file cursor.

Set to true if this function call should wait until either Break mode or Design mode is entered before returning. Set to false if you want this call to return immediately after causing the debugger to begin execution. Upon return the debugger could be in Design, Break, or Run modes.See Code Stepping Overview for more information.

Sets the next instruction to be executed, according to the cursor position in the current source file.

Sets various settings for the .PDB symbols used by Visual Studio for debugging and forces reloading of all symbols.

The path to the location of the .PDB symbol files. A string that contains one character for each symbol path. If the symbol path is enabled, the character has a value of "1". If the symbol path not enabled, the character can have any other value. The path to the location of the cache used for downloading symbols from a symbol server. Set to true if symbols should only be loaded manually, false if symbols should be loaded automatically. Set to true if symbols should be loaded immediately; otherwise false.

Steps into the next function call, if possible.

Set to true if this function call should wait until either Break mode or Design mode is entered before returning. Set to false if you want this call to return immediately after causing the debugger to begin execution. Upon return the debugger could be in Design, Break, or Run-mode.

Steps out of the current function.

Set to true if this function call should wait until either Break mode or Design mode is entered before returning. Set to false if you want this call to return immediately after causing the debugger to begin execution. Upon return the debugger could be in Design, Break, or Run modes.

Steps over the next function call.

Set to true if this function call should wait until either Break mode or Design mode is entered before returning. Set to false if you want this call to return immediately after causing the debugger to begin execution. Upon return the debugger could be in Design, Break, or Run modes.

Stops debugging and terminates or detaches from all attached processes.

Set to true if the debugging session should stop only when it reaches Design mode. Set to false if you intend to stop debugging, but you have to perform other tasks in the macro before the debugger enters design mode.

Gets a string that contains the path to the symbols cache used by Visual Studio when you download symbols from a symbols server. You can specify the symbols cache path in the Options dialog box. For more information, see [OBSOLETE] How to: Use a Symbol Server.

A string that contains the path to the symbols cache.

Gets a string that contains paths to .PDB symbol files that are used by Visual Studio for debugging. The Visual Studio user can specify symbols paths in the Options dialog box. For more information, see [OBSOLETE] How to: Specify Symbol Locations and Loading Behavior.

A string that contains a semicolon delimited list of paths to the .PDB symbol files.

Gets a string that represents the state of all symbol paths for the .PDB symbol files that are used by Visual Studio for debugging.

A string that contains one character for each symbol path. If the symbol path is enabled, the character has a value of "1". If the symbol path not enabled, the character can have any other value.

Terminates all currently running debugging processes.

Gets a collection of supported debugging transports.

A collection.

If debugging a program and in Break mode, this function creates a minidump of the current debugging session.

The file name of the program being debugged. A constant specifying whether a full or normal dump is written.

The object is used to examine and manipulate processes. The object supersedes the , , and objects. To use , you must add a reference to EnvDTE90a.dll. For native development, you must add a reference to dte90a.tlb.

Causes the debugger to attach this process.

Similar to , causes the debugger to attach this process, only it allows you to specify an engine or set of engines.

A collection.

Causes the given process to pause its execution so that its current state can be analyzed.

Set to true to return only when the debugger has entered break mode. Set to false to break and return immediately. See Breaking Execution for more information.

Gets a collection that contains the object that supports this property or is contained within this code construct.

A collection.

Gets the command line that started the program being debugged in Visual Studio. This is a read-only property.

A string that contains the command line.

Gets the current directory of the process being debugged. This is a read-only property.

String that contains the path to the current directory of the process.

Causes the debugger to detach from this process.

Set to true if the debugging session should stop only when it reaches a break or the end. Set to false if you intend to stop debugging, but you have to perform other tasks in the macro before the debugger breaks or ends. For more information, see Breaking Execution.

Gets the top-level extensibility object, the object.

A object.

This read-only property returns an array that contains the environment variables defined for the process being debugged.

Safe array of environment variables. Like most arrays used in Visual Studio automation, this array is 1-indexed.

Gets whether the current process is being debugged.

true if the process is being debugged, false otherwise.

Gets a collection of module objects associated with this process.

A collection.

Gets the name of the process.

A string that represents the name of the process.

Gets the immediate parent object of a object.

A object.

Gets the ID number assigned to this process.

An value that represents the ID number of the process.

Gets a collection of objects.

A collection.

Terminates this process.

Gets the threads associated with this process.

A collection, each representing a thread in the process.

Gets the being used to debug this process.

A object.

Gets a computer name or an IP address.

A string that contains a transport qualifier.

Gets the user name associated with this process.

A string that represents the user name.

The object is used to examine and control stack frames. A stack frame is essentially the same as a function call. To use , you must add a reference to EnvDTE90a.dll. For native development, you must add a reference to dte90a.tlb.

Gets a collection of expressions that represent the arguments passed to this frame.

An collection.

Gets a collection of expressions that represent the arguments passed to this frame. Allows caller to specify whether properties and implicit function calls should be automatically evaluated.

An collection. Determines whether properties and implicit function calls should be automatically evaluated. true means that automatic evaluation will be performed. false means automatic evaluation will not be performed. This parameter affects the returned expressions and any children of those expressions.

Gets the collection that contains the object that supports this property or that is contained within this code construct.

A collection.

Gets the depth of the frame in the stack. A read-only property.

A value indicating how deeply the frame lies within the stack. This value is 1-based, not 0-based. In other words, the top frame on the stack is number 1, not number 0.

Gets the top-level extensibility object.

A object.

Gets the complete file path to the source file that contains this stack frame. A read-only property.

A string that contains the file path.

Gets the function name of this stack frame.

The function name of this stack frame.

Gets the programming language associated with the stack frame.

A constant.

Gets the line number in the source file that contains this stack frame. A read-only property.

An unsigned integer value indicating the line number.

Gets a collection of expressions that represent the locals currently known by this frame.

An collection.

Gets a collection of expressions that represent the locals currently known by this frame. Similar to , but allows the caller to specify whether automatic evaluation of properties and implicit function calls should be performed.

Gets the module name for this stack frame. A module is a group of functions.

A string representing a module name for this stack frame.

Gets the immediate parent object of a object.

A object.

Gets a string that contains the return type for the stack property.

A string that contains the return type for the stack property.

Gets a value indicating whether the frame is user code, also known as "My Code." A read-only property.

Returns true if the frame is user code; false if the frame is not user code. Always returns true for native code.