DebuggerNonUserCodeAttribute クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DebuggerNonUserCodeAttribute クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーションのユーザーコードの一部ではない型またはメンバを識別します。

名前空間: System.Diagnostics
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As DebuggerNonUserCodeAttribute

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

C++

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

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

JScript

SerializableAttribute 
AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Struct|AttributeTargets.Constructor|AttributeTargets.Method|AttributeTargets.Property,
 Inherited=false) 
ComVisibleAttribute(true) 
public final class DebuggerNonUserCodeAttribute
 extends Attribute

解説

ユーザーが作成したコードの一部ではなく、デザイナに用意された型およびメンバにより、デバッグ作業が複雑化することがあります。この属性を適用すると、これらの補助的な型およびメンバはデバッガウィンドウに表示されず、デザイナのコードのステップインではなくステップ実行が自動的に開始されます。デバッガがユーザーコードのステップ実行中にこの属性を検出すると、デザイナのコードをユーザーに表示せずに、ユーザーが作成した次のコードステートメントに移動します。

メモ
共通言語ランタイムは、この属性にセマンティクスを割り当てません。これは、ソースコードデバッガで使用するために提供されています。たとえば、Visual Studio 2005 では、デバッガはこの属性を含む要素をデバッガウィンドウに表示せず、この属性を含むメソッドで停止せず、ブレークポイントをメソッドに設定することを許可しません。

メモ

共通言語ランタイムは、この属性にセマンティクスを割り当てません。これは、ソースコードデバッガで使用するために提供されています。たとえば、Visual Studio 2005 では、デバッガはこの属性を含む要素をデバッガウィンドウに表示せず、この属性を含むメソッドで停止せず、ブレークポイントをメソッドに設定することを許可しません。

DebuggerNonUserCodeAttribute が存在する場合のデバッガの動作は、DebuggerHiddenAttribute 属性 (コードをデバッガから隠す) と DebuggerStepThroughAttribute 属性 (適用対象のコードのステップインではなくステップ実行を開始するようにデバッガに指示する) の組み合わせに似ています。

使用例

この属性を Visual Basic プロジェクトで使用するコード例を次に示します。

' 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