TraceSection クラス

  • [アーティクル]

ASP.NET コード トレース サービスを構成します。

構文

class TraceSection : ConfigurationSection

メソッド

次の表に、TraceSection クラスによって公開されるメソッドの一覧を示します。

名前 説明
GetAllowDefinition (ConfigurationSection から継承。)
GetAllowLocation (ConfigurationSection から継承。)
RevertToParent (ConfigurationSection から継承。)
SetAllowDefinition (ConfigurationSection から継承。)
SetAllowLocation (ConfigurationSection から継承。)

プロパティ

次の表は、TraceSection クラスによって公開されるプロパティの一覧です。

名前 説明
Enabled オプションの読み取り/書き込みの boolean 値。 ASP.NET アプリケーションに対してトレースが有効になっている場合は true、それ以外の場合は false です。 既定値は、false です。

トレースが有効になっている場合、URL http://<servername>/<applicationroot>/trace.axd にある Trace.axd ビューアを使用して、ログに記録されたエラーを表示できます。 ビューアーを使用するには、Enabled プロパティを true に設定する必要があります。 注: Trace.axd は、既定で Applicationhost.config ファイルの <httpHandlers> セクションに追加されます。
LocalOnly オプションの読み取り/書き込みの boolean 値。 トレース ビューアー (Trace.axd) がホスト Web サーバーでのみ使用できる場合は true、トレース ビューアーが任意のコンピューターから使用できる場合は false です。 既定値は、true です。
Location (ConfigurationSection から継承。)キー プロパティ。
MostRecent オプションの読み取り/書き込みの boolean 値。 トレース ストアが最新のトレース メッセージの収集を継続し、RequestLimit で指定された制限に達したときに古いトレース メッセージの破棄を開始する場合は true、RequestLimit で指定された数に達したときにトレース ストアがトレース メッセージの収集を停止する場合は false です。 既定値は、false です。 注意: このプロパティは、.NET Framework 2.0 で新しく追加されました。
PageOutput オプションの読み取り/書き込みの boolean 値。 トレース情報が各 Web ページの下部に追加される場合は true、トレース出力にトレース ユーティリティを通じてのみアクセスできる場合は false です。 既定値は、false です。 注: ASP.NET トレース ビューア ユーティリティの詳細については、「方法: Trace Viewer を使用して ASP.NET トレース情報を表示する」を参照してください。
Path (ConfigurationSection から継承。)キー プロパティ。
RequestLimit サーバーに保存するトレース リクエストの数を 0 ～ 10000 の範囲で指定する、オプションの読み取り/書き込み sint32 値。 既定値は 10 です。 制限に達し、MostRecent プロパティが false の場合、トレースは停止します。 注: RequestLimit プロパティには 0 ～ 2147483647 の範囲の整数値が受け入れられますが、10000 より大きい値を指定すると、ASP.NET は暗黙的にその値を 10000 に切り捨てます。
SectionInformation (ConfigurationSection から継承。)
TraceMode トレース情報を表示する順序を指定する、省略可能な読み取り/書き込み sint32 値。 使用できる値の一覧は、後述の「注釈」セクションに示します。
WriteToDiagnosticsTrace オプションの読み取り/書き込みの boolean 値。 ASP.NET トレース メッセージが、トレース メッセージを表示するために登録されているリスナーの System.Diagnostics トレース インフラストラクチャに転送される場合は true、それ以外の場合は、false です。 既定値は、false です。 注: このプロパティは、.NET Framework 2.0 で新しく追加されました。

サブクラス

このクラスにはサブクラスが含まれていません。

解説

次の表に、TraceMode プロパティとして使用できる値の一覧を示します。 既定値は 1 (SortByTime) です。

Value キーワード 説明
1 SortByTime トレース情報を処理順に表示することを指定します。
2 SortByCategory ページまたはサーバー制御コードの System.Web.TraceContext.Warn メソッド呼び出しと System.Web.TraceContext.Write メソッド呼び出しで指定されたユーザー定義カテゴリによってトレース情報がアルファベット順に表示されることを指定します。

継承階層

ConfigurationSection

TraceSection

要件

型 説明
クライアント - Windows Vista 上の IIS 7.0
- Windows 7 上の IIS 7.5
- Windows 8 上の IIS 8.0
- Windows 10 上の IIS 10.0
[サーバー] - Windows Server 2008 上の IIS 7.0
- Windows Server 2008 R2 上の IIS 7.5
- Windows Server 2012 上の IIS 8.0
- Windows Server 2012 R2 上の IIS 8.5
- Windows Server 2016 上の IIS 10.0
Product - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF ファイル WebAdministration.mof

参照

System.Web.TraceContextConfigurationSection クラス
trace 要素 (ASP.NET 設定スキーマ)
方法:ASP.NET ページのトレースを有効にする
System.Web.TraceContext メソッド