TraceSection Klas

Definitie

Hiermee configureert u de ASP.NET traceringsservice. Deze klasse kan niet worden overgenomen.

public ref class TraceSection sealed : System::Configuration::ConfigurationSection
public sealed class TraceSection : System.Configuration.ConfigurationSection
type TraceSection = class
    inherit ConfigurationSection
Public NotInheritable Class TraceSection
Inherits ConfigurationSection
Overname

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u het TraceSection type gebruikt.

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

Opmerkingen

De TraceSection klasse biedt een manier om programmatisch toegang te krijgen tot en de inhoud van de sectie met configuratiebestanden trace te wijzigen. De sectie trace configureert de ASP.NET traceringsfunctionaliteit en bepaalt hoe traceringsresultaten worden verzameld, opgeslagen en weergegeven.

Wanneer tracering is ingeschakeld, genereert elke paginaaanvraag traceringsberichten die kunnen worden toegevoegd aan de pagina-uitvoer of die in een toepassingstraceringslogboek kunnen worden opgeslagen. U kunt de ASP.NET trace viewer (Trace.axd) gebruiken om de inhoud van het traceringslogboek weer te geven.

Constructors

Name Description
TraceSection()

Initialiseert een nieuw exemplaar van de TraceSection klasse met behulp van standaardinstellingen.

Eigenschappen

Name Description
CurrentConfiguration

Hiermee wordt een verwijzing opgehaald naar het exemplaar op het hoogste niveau Configuration dat de configuratiehiërarchie vertegenwoordigt waartoe het huidige ConfigurationElement exemplaar behoort.

(Overgenomen van ConfigurationElement)
ElementInformation

Hiermee haalt u een ElementInformation object op dat de niet-aanpasbare informatie en functionaliteit van het ConfigurationElement object bevat.

(Overgenomen van ConfigurationElement)
ElementProperty

Hiermee haalt u het ConfigurationElementProperty object op dat het ConfigurationElement object zelf vertegenwoordigt.

(Overgenomen van ConfigurationElement)
Enabled

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de ASP.NET traceringsservice is ingeschakeld.

EvaluationContext

Hiermee haalt u het ContextInformation object voor het ConfigurationElement object op.

(Overgenomen van ConfigurationElement)
HasContext

Hiermee wordt een waarde opgehaald die aangeeft of de CurrentConfiguration eigenschap is null.

(Overgenomen van ConfigurationElement)
Item[ConfigurationProperty]

Hiermee wordt een eigenschap of kenmerk van dit configuratie-element opgehaald of ingesteld.

(Overgenomen van ConfigurationElement)
Item[String]

Hiermee wordt een eigenschap, kenmerk of onderliggend element van dit configuratie-element opgehaald of ingesteld.

(Overgenomen van ConfigurationElement)
LocalOnly

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de ASP.NET trace viewer (Trace.axd) alleen beschikbaar is voor aanvragen van de hostwebserver.

LockAllAttributesExcept

Hiermee haalt u de verzameling vergrendelde kenmerken op.

(Overgenomen van ConfigurationElement)
LockAllElementsExcept

Hiermee haalt u de verzameling vergrendelde elementen op.

(Overgenomen van ConfigurationElement)
LockAttributes

Hiermee haalt u de verzameling vergrendelde kenmerken op.

(Overgenomen van ConfigurationElement)
LockElements

Hiermee haalt u de verzameling vergrendelde elementen op.

(Overgenomen van ConfigurationElement)
LockItem

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het element is vergrendeld.

(Overgenomen van ConfigurationElement)
MostRecent

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de meest recente aanvragen altijd op de server worden opgeslagen.

PageOutput

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de ASP.NET traceringsgegevens worden toegevoegd aan de uitvoer van elke pagina.

Properties

Hiermee haalt u de verzameling eigenschappen op.

(Overgenomen van ConfigurationElement)
RequestLimit

Hiermee wordt een waarde opgehaald of ingesteld die het maximum aantal aanvragen aangeeft aan de toepassing waarvoor ASP.NET traceringsgegevens opslaat.

SectionInformation

Hiermee haalt u een SectionInformation object op dat de niet-aanpasbare informatie en functionaliteit van het ConfigurationSection object bevat.

(Overgenomen van ConfigurationSection)
TraceMode

Hiermee wordt de volgorde opgehaald of ingesteld waarin ASP.NET traceringsgegevens worden weergegeven.

WriteToDiagnosticsTrace

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de berichten die via de paginatracering worden verzonden, worden doorgestuurd naar een exemplaar van de Trace klasse.

Methoden

Name Description
DeserializeElement(XmlReader, Boolean)

Leest XML uit het configuratiebestand.

(Overgenomen van ConfigurationElement)
DeserializeSection(XmlReader)

Leest XML uit het configuratiebestand.

(Overgenomen van ConfigurationSection)
Equals(Object)

Vergelijkt het huidige ConfigurationElement exemplaar met het opgegeven object.

(Overgenomen van ConfigurationElement)
GetHashCode()

Hiermee haalt u een unieke waarde op die het huidige ConfigurationElement exemplaar vertegenwoordigt.

(Overgenomen van ConfigurationElement)
GetRuntimeObject()

Retourneert een aangepast object wanneer dit wordt overschreven in een afgeleide klasse.

(Overgenomen van ConfigurationSection)
GetTransformedAssemblyString(String)

Retourneert de getransformeerde versie van de opgegeven assemblynaam.

(Overgenomen van ConfigurationElement)
GetTransformedTypeString(String)

Retourneert de getransformeerde versie van de opgegeven typenaam.

(Overgenomen van ConfigurationElement)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
Init()

Hiermee stelt u het object in op de ConfigurationElement oorspronkelijke status.

(Overgenomen van ConfigurationElement)
InitializeDefault()

Wordt gebruikt om een standaardset waarden voor het ConfigurationElement object te initialiseren.

(Overgenomen van ConfigurationElement)
IsModified()

Geeft aan of dit configuratie-element is gewijzigd sinds het voor het laatst is opgeslagen of geladen wanneer dit is geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationSection)
IsReadOnly()

Hiermee wordt een waarde opgehaald die aangeeft of het ConfigurationElement object het kenmerk Alleen-lezen heeft.

(Overgenomen van ConfigurationElement)
ListErrors(IList)

Voegt de fouten met ongeldige eigenschappen in dit ConfigurationElement object en in alle subelementen toe aan de doorgegeven lijst.

(Overgenomen van ConfigurationElement)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
OnDeserializeUnrecognizedAttribute(String, String)

Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend kenmerk wordt aangetroffen tijdens deserialisatie.

(Overgenomen van ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend element wordt aangetroffen tijdens deserialisatie.

(Overgenomen van ConfigurationElement)
OnRequiredPropertyNotFound(String)

Genereert een uitzondering wanneer een vereiste eigenschap niet wordt gevonden.

(Overgenomen van ConfigurationElement)
PostDeserialize()

Gebeld na ontserialisatie.

(Overgenomen van ConfigurationElement)
PreSerialize(XmlWriter)

Aangeroepen vóór serialisatie.

(Overgenomen van ConfigurationElement)
Reset(ConfigurationElement)

Hiermee stelt u de interne status van het ConfigurationElement object opnieuw in, inclusief de vergrendelingen en de eigenschappenverzamelingen.

(Overgenomen van ConfigurationElement)
ResetModified()

Hiermee stelt u de waarde van de methode IsModified() opnieuw in wanneer deze false wordt geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationSection)
SerializeElement(XmlWriter, Boolean)

Schrijft de inhoud van dit configuratie-element naar het configuratiebestand wanneer deze wordt geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)

Hiermee maakt u een XML-tekenreeks met een niet-gekoppelde weergave van het ConfigurationSection object als één sectie om naar een bestand te schrijven.

(Overgenomen van ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)

Hiermee schrijft u de buitenste tags van dit configuratie-element naar het configuratiebestand wanneer het wordt geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Hiermee stelt u een eigenschap in op de opgegeven waarde.

(Overgenomen van ConfigurationElement)
SetReadOnly()

Hiermee stelt u de IsReadOnly() eigenschap voor het ConfigurationElement object en alle subelementen in.

(Overgenomen van ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)

Geeft aan of het opgegeven element moet worden geserialiseerd wanneer de hiërarchie van het configuratieobject wordt geserialiseerd voor de opgegeven doelversie van het .NET Framework.

(Overgenomen van ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)

Geeft aan of de opgegeven eigenschap moet worden geserialiseerd wanneer de configuratieobjecthiërarchie wordt geserialiseerd voor de opgegeven doelversie van het .NET Framework.

(Overgenomen van ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)

Hiermee wordt aangegeven of de huidige ConfigurationSection-instantie moet worden geserialiseerd wanneer de hiërarchie van het configuratieobject wordt geserialiseerd voor de opgegeven doelversie van het .NET Framework.

(Overgenomen van ConfigurationSection)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Hiermee wijzigt u het ConfigurationElement object om alle waarden te verwijderen die niet mogen worden opgeslagen.

(Overgenomen van ConfigurationElement)

Van toepassing op

Zie ook