TraceContext.IsEnabled プロパティ

[アーティクル]
06/26/2007

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

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

構文

'宣言
Public Property IsEnabled As Boolean
'使用
Dim instance As TraceContext
Dim value As Boolean

value = instance.IsEnabled

instance.IsEnabled = value

public bool IsEnabled { get; set; }

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

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

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

public function get IsEnabled () : boolean

public function set IsEnabled (value : boolean)

適用できません。

プロパティ値

トレースが有効な場合は true。それ以外の場合は false。

解説

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

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

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

使用例

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

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());
    }
}

プラットフォーム

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

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

次の方法で共有

TraceContext.IsEnabled プロパティ

構文

プロパティ値

解説

使用例

プラットフォーム

バージョン情報

.NET Framework

参照

関連項目

その他の技術情報

その他のリソース