TraceSection クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ASP.NET トレース サービスを設定します。 このクラスは継承できません。
public ref class TraceSection sealed : System::Configuration::ConfigurationSectionpublic sealed class TraceSection : System.Configuration.ConfigurationSectiontype TraceSection = class
inherit ConfigurationSectionPublic NotInheritable Class TraceSection
Inherits ConfigurationSection- 継承
例
次のコード例は、 型の使用方法を TraceSection 示しています。
using System;
using System.Collections;
using System.Collections.Specialized;
using System.IO;
using System.Text;
using System.Text.RegularExpressions;
using System.Configuration;
using System.Web.Configuration;
namespace Samples.Aspnet.SystemWebConfiguration
{
// Accesses the System.Web.Configuration.TraceSection members
// selected by the user.
class UsingTraceSection
{
public static void Main()
{
// Process the System.Web.Configuration.TraceSectionobject.
try
{
// Get the Web application configuration.
System.Configuration.Configuration configuration =
System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnet");
// Get the section.
System.Web.Configuration.TraceSection traceSection =
(System.Web.Configuration.TraceSection)
configuration.GetSection("system.web/trace");
// Get the current PageOutput property value.
Boolean pageOutputValue = traceSection.PageOutput;
// Set the PageOutput property to true.
traceSection.PageOutput = true;
// Get the current WriteToDiagnosticsTrace property value.
Boolean writeToDiagnosticsTraceValue = traceSection.WriteToDiagnosticsTrace;
// Set the WriteToDiagnosticsTrace property to true.
traceSection.WriteToDiagnosticsTrace = true;
// Get the current MostRecent property value.
Boolean mostRecentValue = traceSection.MostRecent;
// Set the MostRecent property to true.
traceSection.MostRecent = true;
// Get the current RequestLimit property value.
Int32 requestLimitValue = traceSection.RequestLimit;
// Set the RequestLimit property to 256.
traceSection.RequestLimit = 256;
// Get the current LocalOnly property value.
Boolean localOnlyValue = traceSection.LocalOnly;
// Set the LocalOnly property to false.
traceSection.LocalOnly = false;
// Get the current Enabled property value.
Boolean enabledValue = traceSection.Enabled;
// Set the Enabled property to false.
traceSection.Enabled = false;
// Get the current Mode property value.
// TraceDisplayMode modeValue = traceSection.TraceMode;
// Set the Mode property to TraceDisplayMode.SortyByTime.
// traceSection.Mode = TraceDisplayMode.SortByTime;
// Update if not locked.
if (!traceSection.SectionInformation.IsLocked)
{
configuration.Save();
Console.WriteLine("** Configuration updated.");
}
else
{
Console.WriteLine("** Could not update, section is locked.");
}
}
catch (System.ArgumentException e)
{
// Unknown error.
Console.WriteLine(
"A invalid argument exception detected in UsingTraceSection Main. Check your");
Console.WriteLine("command line for errors.");
}
}
} // UsingTraceSection class end.
} // Samples.Aspnet.SystemWebConfiguration namespace end.
Imports System.Collections
Imports System.Collections.Specialized
Imports System.IO
Imports System.Text
Imports System.Text.RegularExpressions
Imports System.Configuration
Imports System.Web.Configuration
Namespace Samples.Aspnet.SystemWebConfiguration
' Accesses the System.Web.Configuration.TraceSection members
' selected by the user.
Class UsingTraceSection
Public Shared Sub Main()
' Process the System.Web.Configuration.TraceSectionobject.
Try
' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration = _
System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration("/aspnet")
' Get the section.
Dim traceSection As System.Web.Configuration.TraceSection = _
CType(configuration.GetSection("system.web/trace"), _
System.Web.Configuration.TraceSection)
' Get the current PageOutput property value.
Dim pageOutputValue As Boolean = traceSection.PageOutput
' Set the PageOutput property to true.
traceSection.PageOutput = True
' Get the current WriteToDiagnosticsTrace property value.
Dim writeToDiagnosticsTraceValue As Boolean = traceSection.WriteToDiagnosticsTrace
' Set the WriteToDiagnosticsTrace property to true.
traceSection.WriteToDiagnosticsTrace = True
' Get the current MostRecent property value.
Dim mostRecentValue As Boolean = traceSection.MostRecent
' Set the MostRecent property to true.
traceSection.MostRecent = True
' Get the current RequestLimit property value.
Dim requestLimitValue As Int32 = traceSection.RequestLimit
' Set the RequestLimit property to 256.
traceSection.RequestLimit = 256
' Get the current LocalOnly property value.
Dim localOnlyValue As Boolean = traceSection.LocalOnly
' Set the LocalOnly property to false.
traceSection.LocalOnly = False
' Get the current Enabled property value.
Dim enabledValue As Boolean = traceSection.Enabled
' Set the Enabled property to false.
traceSection.Enabled = False
' Get the current Mode property value.
'Dim modeValue As TraceDisplayMode = traceSection.TraceMode
' Set the Mode property to TraceDisplayMode.SortByTime.
'traceSection.Mode = TraceDisplayMode.SortByTime
' Update if not locked.
If Not traceSection.SectionInformation.IsLocked Then
configuration.Save()
Console.WriteLine("** Configuration updated.")
Else
Console.WriteLine("** Could not update, section is locked.")
End If
Catch e As System.ArgumentException
' Unknown error.
Console.WriteLine( _
"A invalid argument exception detected in UsingTraceSection Main. Check your")
Console.WriteLine("command line for errors.")
End Try
End Sub
End Class
End Namespace ' Samples.Aspnet.SystemWebConfiguration
注釈
クラスは TraceSection 、構成ファイル trace セクションの内容にプログラムでアクセスして変更する方法を提供します。 セクションでは trace 、ASP.NET トレース機能を構成し、トレース結果の収集、格納、および表示方法を制御します。
トレースが有効になっている場合、各ページ要求は、ページ出力に追加したり、アプリケーション トレース ログに格納したりできるトレース メッセージを生成します。 ASP.NET トレース ビューアー (Trace.axd) を使用して、トレース ログの内容を表示できます。
コンストラクター
| TraceSection() |
既定の設定を使用して TraceSection クラスの新しいインスタンスを初期化します。 |
プロパティ
| CurrentConfiguration |
現在の Configuration インスタンスが属している構成階層を表す最上位の ConfigurationElement インスタンスへの参照を取得します。 (継承元 ConfigurationElement) |
| ElementInformation |
ElementInformation オブジェクトのカスタマイズできない情報と機能を格納する ConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement) |
| ElementProperty |
ConfigurationElementProperty オブジェクト自体を表す ConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement) |
| Enabled |
ASP.NET トレース サービスが有効になっているかどうかを示す値を取得または設定します。 |
| EvaluationContext |
ContextInformation オブジェクトの ConfigurationElement オブジェクトを取得します。 (継承元 ConfigurationElement) |
| HasContext |
CurrentConfiguration プロパティが |
| Item[ConfigurationProperty] |
この構成要素のプロパティまたは属性を取得または設定します。 (継承元 ConfigurationElement) |
| Item[String] |
この構成要素のプロパティ、属性、または子要素を取得または設定します。 (継承元 ConfigurationElement) |
| LocalOnly |
ホスト Web サーバーからの要求に対してのみ ASP.NET トレース サービス (Trace.axd) を使用できるかどうかを示す値を取得または設定します。 |
| LockAllAttributesExcept |
ロックされている属性のコレクションを取得します。 (継承元 ConfigurationElement) |
| LockAllElementsExcept |
ロックされている要素のコレクションを取得します。 (継承元 ConfigurationElement) |
| LockAttributes |
ロックされている属性のコレクションを取得します。 (継承元 ConfigurationElement) |
| LockElements |
ロックされている要素のコレクションを取得します。 (継承元 ConfigurationElement) |
| LockItem |
要素がロックされているかどうかを示す値を取得または設定します。 (継承元 ConfigurationElement) |
| MostRecent |
最新の要求が常にサーバー上に格納されるかどうかを示す値を取得または設定します。 |
| PageOutput |
ASP.NET のトレース情報が各ページの出力に追加されるかどうかを示す値を取得または設定します。 |
| Properties |
プロパティのコレクションを取得します。 (継承元 ConfigurationElement) |
| RequestLimit |
アプリケーションに対して ASP.NET がトレース情報を格納する最大要求数を示す値を取得または設定します。 |
| SectionInformation |
SectionInformation オブジェクトのカスタマイズできない情報と機能を格納する ConfigurationSection オブジェクトを取得します。 (継承元 ConfigurationSection) |
| TraceMode |
ASP.NET のトレース情報が表示される順序を取得または設定します。 |
| WriteToDiagnosticsTrace |
ページ トレースを通じて発行されたメッセージが Trace クラスのインスタンスに転送されるかどうかを示す値を取得または設定します。 |
メソッド
適用対象
こちらもご覧ください
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET