TraceContext.IsEnabled プロパティ

定義

名前空間:

System.Web

アセンブリ:

System.Web.dll

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

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

public bool IsEnabled { get; set; }

member this.IsEnabled : bool with get, set

Public Property IsEnabled As Boolean

プロパティ値

Boolean

トレースが有効な場合は true、それ以外の場合は false を指定します。

例

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

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.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

注釈

このフラグを使用して、ページまたはアプリケーションがトレース ログに何かを書き込む前にトレース情報を出力する必要があるかどうかを確認します。

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

注意

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

こちらもご覧ください

• ASP.NET のトレースの概要
• <trace> 要素