ExceptionSettings Interface

Definition

Namespace:

EnvDTE90

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.11.40262

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

public interface class ExceptionSettings : System::Collections::IEnumerable

[System.Runtime.InteropServices.Guid("0E1AB53B-4065-4884-A39F-02E16EB57F7D")]
public interface ExceptionSettings : System.Collections.IEnumerable

[<System.Runtime.InteropServices.Guid("0E1AB53B-4065-4884-A39F-02E16EB57F7D")>]
type ExceptionSettings = interface
    interface IEnumerable

Public Interface ExceptionSettings
Implements IEnumerable

Attributes

GuidAttribute

Implements

IEnumerable

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.

Properties

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.

Methods

GetEnumerator()	Gets an enumeration for items in a collection.
Item(Object)	Gets an indexed member of this collection.
ItemFromCode(UInt32)
NewException(String, UInt32)	Creates a new ExceptionSetting object for this category.
Remove(Object)	Deletes the ExceptionSetting object specified by index from the ExceptionSettings collection.
RemoveByCode(UInt32)	Deletes the ExceptionSetting object specified by code from the ExceptionSettings collection.
SetBreakWhenThrown(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.
SetBreakWhenUserUnhandled(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.