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 /DTRACE when compiling.

#using <System.dll>
using namespace System;
using namespace System::Diagnostics;

int main()
{
   #if defined(TRACE)
   Trace::Listeners->Add( gcnew TextWriterTraceListener( Console::Out ) );
   Trace::AutoFlush = true;
   Trace::Indent();
   Trace::WriteLine( "Entering Main" );
   #endif
   Console::WriteLine( "Hello World." );
   #if defined(TRACE)
   Trace::WriteLine( "Exiting Main" );
   Trace::Unindent();
   #endif
   return 0;
}

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

Třídy BooleanSwitch a 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 naleznete v Switch třídy a Postupy: 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 Listeners nebo odebráním instancí. Kolekci Listeners sdílí Debug i třídy Trace; 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 není definován jako symbol podmíněné kompilace. V dokumentaci kompilátoru najdete informace o tom, jestli se ConditionalAttribute podporuje, a syntaxi pro definování symbolu podmíněné kompilace.

Pokud chcete definovat TRACE symbol podmíněné kompilace v jazyce C#, přidejte do příkazového řádku kompilátoru možnost /d:TRACE 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 přidejte #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.

Vlastnosti

Metody

Událost

Platí pro

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