DebuggerNonUserCodeAttribute Class

Definition

Namespace:

System.Diagnostics

Assembly:

System.Runtime.dll

Source:

DebuggerNonUserCodeAttribute.cs

Identifies a type or member that is not part of the user code for an application.

public ref class DebuggerNonUserCodeAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Property | System.AttributeTargets.Struct, Inherited=false)]
public sealed class DebuggerNonUserCodeAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Property | System.AttributeTargets.Struct, Inherited=false)>]
type DebuggerNonUserCodeAttribute = class
    inherit Attribute

Public NotInheritable Class DebuggerNonUserCodeAttribute
Inherits Attribute

Inheritance

Object

Attribute

DebuggerNonUserCodeAttribute

Attributes

AttributeUsageAttribute

Examples

The following code example shows the use of this attribute in a Visual Basic project.

' Form overrides Dispose to clean up the component list.  
<System.Diagnostics.DebuggerNonUserCode()> _  
Protected Overloads Overrides Sub Dispose(ByVal disposing As Boolean)  
    If disposing AndAlso components IsNot Nothing Then  
        components.Dispose()  
    End If  
    MyBase.Dispose(disposing)  
End Sub  

Remarks

Designer provided types and members that are not part of the code specifically created by the user can complicate the debugging experience. This attribute suppresses the display of these adjunct types and members in the debugger window and automatically steps through, rather than into, designer provided code. When the debugger encounters this attribute when stepping through user code, the user experience is to not see the designer provided code and to step to the next user-supplied code statement.

Note

The common language runtime attaches no semantics to this attribute. It is provided for use by source code debuggers. For example, in Visual Studio 2005, the debugger does not display an element with this attribute in the debugger window, does not stop in a method with this attribute, and does not allow a breakpoint to be set in the method.

The debugger behavior when the DebuggerNonUserCodeAttribute is present is similar to using a combination of the DebuggerHiddenAttribute attribute, which hides the code from the debugger, and the DebuggerStepThroughAttribute attribute, which tells the debugger to step through, rather than into, the code it is applied to.

Constructors

DebuggerNonUserCodeAttribute()

Initializes a new instance of the DebuggerNonUserCodeAttribute class.

Properties

TypeId

When implemented in a derived class, gets a unique identifier for this Attribute. (Inherited from Attribute)

Methods

Equals(Object)	Returns a value that indicates whether this instance is equal to a specified object. (Inherited from Attribute)
GetHashCode()	Returns the hash code for this instance. (Inherited from Attribute)
GetType()	Gets the Type of the current instance. (Inherited from Object)
IsDefaultAttribute()	When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class. (Inherited from Attribute)
Match(Object)	When overridden in a derived class, returns a value that indicates whether this instance equals a specified object. (Inherited from Attribute)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)