ExceptionSettings Interface

 

A collection of ExceptionSetting objects, each representing a set of exception settings for the debugger.

Namespace:   EnvDTE90
Assembly:  EnvDTE90 (in EnvDTE90.dll)

[GuidAttribute("0E1AB53B-4065-4884-A39F-02E16EB57F7D")]
public interface ExceptionSettings : IEnumerable

NameDescription
System_CAPS_pubpropertyCount

Gets a value indicating the number of exception settings in the ExceptionSettings collection.

System_CAPS_pubpropertyDTE

Gets the top-level extensibility object.

System_CAPS_pubpropertyName

Gets the name of the specified exception setting.

System_CAPS_pubpropertyParent

Gets the immediate parent object of this collection, in this case the Debugger3 object.

System_CAPS_pubpropertySupportsExceptionCodes

Gets whether this exception settings group supports exception codes.

NameDescription
System_CAPS_pubmethodGetEnumerator()

Gets an enumeration for items in a collection.

System_CAPS_pubmethodItem(Object)

Gets an indexed member of this collection.

System_CAPS_pubmethodItemFromCode(UInt32)

System_CAPS_pubmethodNewException(String, UInt32)

Creates a new ExceptionSetting object for this category.

System_CAPS_pubmethodRemove(Object)

Deletes the ExceptionSetting object specified by index from the ExceptionSettings collection.

System_CAPS_pubmethodRemoveByCode(UInt32)

Deletes the ExceptionSetting object specified by code from the ExceptionSettings collection.

System_CAPS_pubmethodSetBreakWhenThrown(Boolean, ExceptionSetting)

Enables or disables the BreakWhenThrown property for the specified ExceptionSetting. The property passed in by the ExceptionSetting object will now reflect this value.

System_CAPS_pubmethodSetBreakWhenUserUnhandled(Boolean, ExceptionSetting)

Enables or disables the BreakWhenUserUnhandled property for the specified ExceptionSetting. The property passed in by the ExceptionSetting object will now reflect this value.

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.

Return to top
Show: