Trace Třída

Definice

public ref class Trace sealed

public sealed class Trace

type Trace = class

Public NotInheritable Class Trace

Dědičnost

Object

Trace

Příklady

Následující příklad používá Trace k označení začátku a konce provádění programu. Příklad také používá Trace.Indent a Trace.Unindent metody k rozlišení výstupu trasování. Podrobnější příklad použití Tracenaleznete v tématu Postupy: Přidání příkazů trasování do kódu aplikace.

// 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

Poznámky

K instrumentaci sestavení vydaných verzí můžete použít vlastnosti a metody ve Trace třídě. Instrumentace umožňuje monitorovat stav aplikace spuštěné v reálném životě. Trasování pomáhá izolovat problémy a opravit je bez narušení spuštěného systému.

Tato třída poskytuje metody pro zobrazení dialogového okna Assert a generování kontrolního výrazu, který bude vždy Fail. Tato třída poskytuje metody zápisu v následujících variantách:

• Write
• WriteLine
• WriteIf
• WriteLineIf

BooleanSwitch Třídy TraceSwitch poskytují prostředky pro dynamické řízení výstupu trasování. V aplikacích .NET Framework můžete upravit hodnoty těchto přepínačů bez opětovného zkompilování aplikace. Informace o použití konfiguračního souboru k nastavení přepínače v aplikaci .NET Framework najdete v Switch třídy a Pokud na: Vytvoření, inicializace a konfigurace přepínačů trasování.

Cíl výstupu trasování můžete přizpůsobit přidáním TraceListener instancí do kolekce nebo odebráním instancí z Listeners kolekce. Kolekce Listeners je sdílena oběma Debug třídami a Trace třídami; přidání naslouchacího procesu trasování do obou tříd přidá naslouchací proces. Ve výchozím nastavení se výstup trasování vygeneruje pomocí třídy DefaultTraceListener.

Třída Trace poskytuje vlastnosti pro získání nebo nastavení úrovně Indent a IndentSizea zda se mají AutoFlush po každém zápisu.

V aplikacích .NET Framework můžete nastavit AutoFlush a IndentSize pro Trace úpravou konfiguračního souboru, který odpovídá názvu aplikace. Konfigurační soubor by měl být formátovaný jako v následujícím příkladu:

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

Atribut ConditionalAttribute se použije na metody Trace. Kompilátory, které podporují ConditionalAttribute ignorovat volání těchto metod, pokud TRACE nejsou definovány jako symbol podmíněné kompilace. Informace o tom, jestli ConditionalAttribute se podporuje, a syntaxi pro definování symbolu podmíněné kompilace najdete v dokumentaci kompilátoru.

Pokud chcete definovat TRACE symbol podmíněné kompilace v jazyce C#, přidejte /d:TRACE možnost do příkazového řádku kompilátoru při kompilaci kódu pomocí příkazového řádku nebo přidejte #define TRACE na začátek souboru. V jazyce Visual Basic přidejte /d:TRACE=True možnost do příkazového řádku kompilátoru nebo do souboru.#Const TRACE=True

ConditionalAttribute kompilátor C++ nepodporuje. Chcete-li poskytovat ekvivalentní funkce, musíte uzavřít volání metod Trace do bloku #if defined(TRACE) ... #endif a přidat /DTRACE možnost do příkazového řádku kompilátoru nebo do souboru přidat #define TRACE.

Bezpečný přístup z více vláken

Tento typ je bezpečný pro přístup z více vláken.

Viz také

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