Trace Osztály

Definíció

public ref class Trace sealed

public sealed class Trace

type Trace = class

Public NotInheritable Class Trace

Öröklődés

Object

Trace

Példák

Az alábbi példa Trace egy program végrehajtásának kezdetét és végét jelzi. A példa a nyomkövetési kimenet megkülönböztetésére is használja a Trace.IndentTrace.Unindent metódusokat. Az alkalmazás használatára vonatkozó teljesebb példa: Trace utasítások hozzáadása az Alkalmazáskódhoz.

// Specify /d:TRACE when compiling.

using System;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));
       Trace.AutoFlush = true;
       Trace.Indent();
       Trace.WriteLine("Entering Main");
       Console.WriteLine("Hello World.");
       Trace.WriteLine("Exiting Main");
       Trace.Unindent();
    }
}

' Specify /d:TRACE=True when compiling.

Imports System.Diagnostics

Class Test
    
    Shared Sub Main()
    
        Trace.Listeners.Add(New TextWriterTraceListener(Console.Out))
        Trace.AutoFlush = True
        Trace.Indent()
        Trace.WriteLine("Entering Main")
        Console.WriteLine("Hello World.")
        Trace.WriteLine("Exiting Main")
        Trace.Unindent()
        
    End Sub

End Class

Megjegyzések

Az osztályban található tulajdonságokat és metódusokat használhatja a Trace rendszerállapot-buildek kiadásához. A Rendszerezés lehetővé teszi az alkalmazás valós környezetben futó állapotának monitorozását. A nyomkövetés segít elkülöníteni a problémákat, és kijavítani őket a futó rendszer megzavarása nélkül.

Ez az osztály metódusokat biztosít egy Assert párbeszédpanel megjelenítéséhez és egy mindig Failérvényes állítás kibocsátásához. Ez az osztály az alábbi változatokban nyújt írási metódusokat:

• Write
• WriteLine
• WriteIf
• WriteLineIf

Az BooleanSwitch osztályokkal TraceSwitch dinamikusan szabályozható a nyomkövetési kimenet. A .NET Framework-alkalmazásokban az alkalmazás újrafordítása nélkül módosíthatja ezeknek a kapcsolóknak az értékeit. További információ arról, hogy a konfigurációs fájl használatával állítson be kapcsolót egy .NET-keretrendszeralkalmazásban, tekintse meg a Switch osztályt és a Hogyan: Nyomkövetési kapcsolók létrehozása, inicializálása és konfigurálása.

A nyomkövetési kimenet célját testre szabhatja, ha példányokat ad hozzá TraceListener a gyűjteményhez, vagy eltávolítja a példányokat a Listeners gyűjteményből. A Listeners gyűjteményt mind az osztályok, mind az DebugTrace osztályok megosztják; a nyomkövetési figyelő bármelyik osztályhoz való hozzáadása mindkét osztályhoz hozzáadja a figyelőt. Alapértelmezés szerint a nyomkövetési kimenet az DefaultTraceListener osztály használatával lesz kibocsátva.

Az Trace osztály tulajdonságokat biztosít az egyes írási szintek és Indentszintek lekéréséhez IndentSize vagy beállításához, valamint az egyes írások után.AutoFlush

A .NET Framework-alkalmazásokban beállíthatja a AutoFlush és IndentSizeTrace beállításához az alkalmazás nevének megfelelő konfigurációs fájlt. A konfigurációs fájlt a következő példához hasonlóan kell formázni:

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="3" />
  </system.diagnostics>
</configuration>

Az ConditionalAttribute attribútum a metódusokra Tracelesz alkalmazva. Azok a fordítók, amelyek támogatják ConditionalAttribute az ilyen metódusok hívásait, kivéve, ha TRACE feltételes fordítási szimbólumként vannak definiálva. Tekintse meg a fordító dokumentációját annak megállapításához, hogy támogatott-e ConditionalAttribute a rendszer, valamint a feltételes fordítási szimbólumok meghatározásának szintaxisát.

A feltételes fordítási szimbólum C#-ban való definiálásához TRACE adja hozzá a /d:TRACE kapcsolót a fordító parancssorához, amikor a kódot parancssor használatával fordítja le, vagy adja hozzá #define TRACE a fájl tetejére. A Visual Basic adja hozzá a /d:TRACE=True beállítást a fordító parancssorához, vagy adja hozzá a #Const TRACE=True a fájlhoz.

ConditionalAttribute A C++ fordító nem támogatja. Az egyenértékű funkciók biztosításához be kell állítania a blokk metódusaihoz Trace#if defined(TRACE) ... #endif tartozó hívásokat, és hozzá kell adnia a /DTRACE beállítást a fordító parancssorához, vagy hozzá kell adnia #define TRACE a fájlhoz.

Szálbiztonság

Ez a típus szálbiztos.

Lásd még

• Debug
• Switch
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• EventLogTraceListener
• TraceListenerCollection
• ConditionalAttribute