Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

TraceSection-Klasse

Konfiguriert den ASP.NET-Ablaufverfolgungsdienst. Diese Klasse kann nicht vererbt werden.

Namespace: System.Web.Configuration
Assembly: System.Web (in system.web.dll)

public sealed class TraceSection : ConfigurationSection
public final class TraceSection extends ConfigurationSection
public final class TraceSection extends ConfigurationSection
Nicht zutreffend.

Die TraceSection-Klasse ermöglicht den programmgesteuerten Zugriff auf den Inhalt des trace-Abschnitts der Konfigurationsdatei und dessen programmgesteuerte Änderung. Im trace-Abschnitt werden die ASP.NET-Ablaufverfolgungsfunktionen konfiguriert und das Erfassen, Speichern und Anzeigen der Ablaufverfolgungsergebnisse gesteuert.

Bei aktivierter Ablaufverfolgung werden durch jede Seitenanforderung Ablaufverfolgungsmeldungen generiert, die an die Seitenausgabe angefügt oder in einem Ablaufverfolgungsprotokoll der Anwendung gespeichert werden können. Mit dem ASP.NET-Ablaufverfolgungs-Viewer (Trace.axd) können Sie den Inhalt des Ablaufverfolgungsprotokolls anzeigen.

HinweisHinweis:

Das trace-Element ist im system.web-Abschnitt der Konfigurationshierarchie in den Dateien Machine.config und Web.config zulässig. In den Konfigurationsdateien der Unterverzeichnisse von Web ist es nicht zulässig.

Im folgenden Codebeispiel wird die Verwendung des TraceSection-Typs veranschaulicht.

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.


Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für 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 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.

.NET Framework

Unterstützt in: 3.0, 2.0
Anzeigen: