TraceContext.IsEnabled TraceContext.IsEnabled TraceContext.IsEnabled TraceContext.IsEnabled Property

定義

現在の Web 要求に対してトレースが有効かどうかを示す値を取得または設定します。Gets or sets a value indicating whether tracing is enabled for the current Web request.

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

プロパティ値

トレースが有効な場合は true、それ以外の場合は false を指定します。true if tracing is enabled; otherwise, false.

次のコード例は、ページに対してトレースが有効になっているかどうかを確認する方法を示しています。The following code example demonstrates how you can determine whether tracing is enabled for a page. このコードでは、データセット内の行ごとにトレースステートメントを記述して、データセット内の行を反復処理します。The code iterates through the rows in a dataset, writing trace statements for each row in that dataset.

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
   

注釈

このフラグは、トレースログに書き込む前に、ページまたはアプリケーションがトレース情報を出力する必要があるかどうかを確認するために使用します。Use this flag to check whether your page or application should output tracing information before it writes anything to the trace log.

IsEnabledプロパティの値は、 system.web構成セクションのサブセクションの設定traceと、ディレクティブの属性の値によって異なります。The value of the IsEnabled property depends on the settings in the subsection of the system.web configuration section and the value of the trace attribute of the directive. Page ディレクティブで設定されたトレースオプションは、構成ファイルで設定されたオプションよりも優先されます。The tracing option set in the page directive takes precedence over the option set in the configuration file. 値をIsEnabledプログラムで設定すると、ページディレクティブ属性と構成設定の両方に優先します。Setting the IsEnabled value programmatically takes precedence over both the page directive attribute and the configuration setting.

注意

アプリケーション全体に対しIsEnabledてプロパティtrueをに設定する場合は、トレース情報を表示しfalseないアプリケーション内の任意のページに対して、このプロパティを明示的にに設定する必要があります。If you set the IsEnabled property to true for an entire application, you must explicitly set this property to false for any page in the application for which you do not want tracing information displayed.

適用対象

こちらもご覧ください