ExceptionSettings Interface
A collection of ExceptionSetting objects, each representing a set of exception settings for the debugger.
Namespace: EnvDTE90
Assembly: EnvDTE90 (in EnvDTE90.dll)
Syntax
'Declaration
<GuidAttribute("0E1AB53B-4065-4884-A39F-02E16EB57F7D")> _
Public Interface ExceptionSettings _
Inherits IEnumerable
[GuidAttribute("0E1AB53B-4065-4884-A39F-02E16EB57F7D")]
public interface ExceptionSettings : IEnumerable
[GuidAttribute(L"0E1AB53B-4065-4884-A39F-02E16EB57F7D")]
public interface class ExceptionSettings : IEnumerable
[<GuidAttribute("0E1AB53B-4065-4884-A39F-02E16EB57F7D")>]
type ExceptionSettings =
interface
interface IEnumerable
end
public interface ExceptionSettings extends IEnumerable
The ExceptionSettings type exposes the following members.
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
Count | Gets a value indicating the number of exception settings in the ExceptionSettings collection. |
|
DTE | Gets the top-level extensibility object. |
|
Name | Gets the name of the specified exception setting. |
|
Parent | Gets the immediate parent object of this collection, in this case the Debugger3 object. |
|
SupportsExceptionCodes | Gets whether this exception settings group supports exception codes. |
Top
Methods
| Name | Description | |
|---|---|---|
.gif "Public method") |
GetEnumerator | Gets an enumeration for items in a collection. |
|
Item | Gets an indexed member of this collection. |
|
ItemFromCode | |
|
NewException | Creates a new ExceptionSetting object for this category. |
|
Remove | Deletes the ExceptionSetting object specified by index from the ExceptionSettings collection. |
|
RemoveByCode | Deletes the ExceptionSetting object specified by code from the ExceptionSettings collection. |
|
SetBreakWhenThrown | Enables or disables the BreakWhenThrown property for the specified ExceptionSetting. The property passed in by the ExceptionSetting object will now reflect this value. |
|
SetBreakWhenUserUnhandled | Enables or disables the BreakWhenUserUnhandled property for the specified ExceptionSetting. The property passed in by the ExceptionSetting object will now reflect this value. |
Top
Remarks
ExceptionSettings is an enumerable collection of ExceptionSetting objects. ExceptionSettings objects allow you to programmatically manipulate settings displayed in the Exceptions dialog box in the debugger. They also allow you to programmatically determine which exceptions the debugger breaks on when they are first thrown, or when they are not handled by the user.
The debugger engine can display debugging exceptions in a hierarchical tree view in the Visual Studio integrated development environment (IDE). ExceptionSettings can be used to flatten this tree into a single list of exceptions.
ExceptionSettings can be indexed by name, integer index, or — if the collection supports it — integer code. Some exception groups, such as Native Run-Time Checks and Win32 Exceptions, support integer codes that are unique in that group. The other index types do not support integer codes and all names must be unique.