Share via


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
Public property Count Gets a value indicating the number of exception settings in the ExceptionSettings collection.
Public property DTE Gets the top-level extensibility object.
Public property Name Gets the name of the specified exception setting.
Public property Parent Gets the immediate parent object of this collection, in this case the Debugger3 object.
Public property SupportsExceptionCodes Gets whether this exception settings group supports exception codes.

Top

Methods

  Name Description
Public method GetEnumerator Gets an enumeration for items in a collection.
Public method Item Gets an indexed member of this collection.
Public method ItemFromCode
Public method NewException Creates a new ExceptionSetting object for this category.
Public method Remove Deletes the ExceptionSetting object specified by index from the ExceptionSettings collection.
Public method RemoveByCode Deletes the ExceptionSetting object specified by code from the ExceptionSettings collection.
Public method SetBreakWhenThrown Enables or disables the BreakWhenThrown property for the specified ExceptionSetting. The property passed in by the ExceptionSetting object will now reflect this value.
Public method 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.

See Also

Reference

EnvDTE90 Namespace

ExceptionGroups

Other Resources

Automation Object Model Chart