TraceContext.IsEnabled プロパティとは何？わかりやすく解説 Weblio辞書

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

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

TraceContext.IsEnabled プロパティ

現在の Web 要求に対してトレースが有効かどうかを示す値を取得または設定します。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property IsEnabled As
 Boolean

Visual Basic (使用法)

Dim instance As TraceContext
Dim value As Boolean

value = instance.IsEnabled

instance.IsEnabled = value

public bool IsEnabled { get;
 set; }

C++

public:
property bool IsEnabled {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_IsEnabled ()

/** @property */
public void set_IsEnabled (boolean value)

JScript

public function get IsEnabled
 () : boolean

public function set IsEnabled
 (value : boolean)

プロパティ値
トレースが有効な場合は true。それ以外の場合は false。

解説

このフラグを使用して、トレースログに書き込みを行う前に、ページまたはアプリケーションがトレース情報を出力するかどうかをチェックします。

IsEnabled プロパティの値は、system.web 構成セクションの trace サブセクションの設定、および @ Page ディレクティブの trace 属性の値に依存します。ページディレクティブで設定されたトレースオプションは、構成ファイルで設定されたオプションより優先されます。プログラムで IsEnabled 値を設定すると、ページディレクティブの属性および構成設定のどちらよりも優先されます。

メモ
アプリケーション全体に対して IsEnabled プロパティを true に設定した場合に、そのアプリケーション内にトレース情報を表示しないページがあれば、そのページに対しこのプロパティを明示的に false に設定する必要があります。

使用例

ページに対してトレースが有効になっているかどうかを判断する方法を次のコード例に示します。このコードはデータセット内の行を反復処理し、そのデータセット内の各行に対してトレースステートメントを書き込みます。

Visual Basic

If (Context.IsEnabled)
 
   Dim I As Integer
   For I = 0 To DS.Tables("Categories").Rows.Count
 - 1
 
     Trace.Write("ProductCategory",DS.Tables("Categories").Rows(I)(0).ToString())
   Next
 End If

if (Context.IsEnabled) { 
   for (int i=0; i<DS.Tables["Categories"].Rows.Count;
 i++) { 
     Trace.Write("ProductCategory", DS.Tables["Categories"].Rows[i][0].ToString());
    }
}

if (context.get_IsEnabled()) {
    for(int i=0;i<ds.get_Tables().get_Item("Categories").
            get_Rows().get_Count();i++) {
        Trace.Write("ProductCategory",
        ds.get_Tables().get_Item("Categories").
        get_Rows().get_Item(i).get_Item(0).ToString());
    }
}