DebuggerStepThroughAttribute Class (System.Diagnostics)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

DebuggerStepThroughAttribute Class

Updated: November 2007

Specifies the DebuggerStepThroughAttribute. This class cannot be inherited.

Namespace: System.Diagnostics
Assembly: mscorlib (in mscorlib.dll)

Syntax

Visual Basic (Declaration)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Struct Or AttributeTargets.Constructor Or AttributeTargets.Method, Inherited := False)> _
Public NotInheritable Class DebuggerStepThroughAttribute _
    Inherits Attribute

Visual Basic (Usage)

Dim instance As DebuggerStepThroughAttribute

[SerializableAttribute]
[ComVisibleAttribute(true)]
[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method, Inherited = false)]
public sealed class DebuggerStepThroughAttribute : Attribute

Visual C++

[SerializableAttribute]
[ComVisibleAttribute(true)]
[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Struct|AttributeTargets::Constructor|AttributeTargets::Method, Inherited = false)]
public ref class DebuggerStepThroughAttribute sealed : public Attribute

/** @attribute SerializableAttribute */ 
/** @attribute ComVisibleAttribute(true) */
/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method, Inherited = false) */
public final class DebuggerStepThroughAttribute extends Attribute

JScript

public final class DebuggerStepThroughAttribute extends Attribute

Remarks

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

For more information about using attributes, see Extending Metadata Using Attributes.

Inheritance Hierarchy

System..::.Object
System..::.Attribute
System.Diagnostics..::.DebuggerStepThroughAttribute

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 2.0, 1.0

Reference

DebuggerStepThroughAttribute Members

System.Diagnostics Namespace

Tags

: Add a tag

Community Content

Add new content

Annotations

Not sure I get this

EugenP | Edit |

So this attribute it allows setting a breakpoint in a method but the debugger will not stop. Does this make sense?

Tags

: Add a tag

Flag as ContentBug

Strange choice of AttributeTargets

Merak | Edit |

The attribute only targets, entire classes or structs, and methods.

However properties (which are more likely to be so basic that stepping over them makes most sense) cannot have this attribute.

To apply this to properties, you have to apply it to the specific get or set, eg

publicstring SomeProperty
{
[System.Diagnostics.DebuggerStepThrough]
get
{
string prop = (string)ViewState["Property"];
return (prop == null) ? String.Empty : prop;
}
[System.Diagnostics.DebuggerStepThrough]
set
{
ViewState["Property"] = value;
}
}

Tags

: contentbug (x) Add a tag

No information about what it does?

lukevenediger ... Stanley Roark | Edit |

This line: "Specifies the DebuggerStepThroughAttribute. This class cannot be inherited." is not at all useful. Please give some information on what it does and list some common usage scenarios?

Tags

: contentbug (x) contentsuggestion (x) Add a tag

Click here for helpful info

FX Swede | Edit |

This blog entry helped me.
http://mark.michaelis.net/Blog/SystemDiagnosticsDebuggerStepThroughAndMoreSystemDiagnosticsNamespaceStuff.aspx

Tags

: Add a tag

Flag as ContentBug