Trace Klasa

Definicja

public ref class Trace sealed

public sealed class Trace

type Trace = class

Public NotInheritable Class Trace

Dziedziczenie

Object

Trace

Przykłady

W poniższym przykładzie użyto Trace metody , aby wskazać początek i koniec wykonywania programu. W przykładzie użyto Trace.Indent również metod i Trace.Unindent do odróżnienia danych wyjściowych śledzenia. Aby uzyskać bardziej kompletny przykład użycia programu Trace, zobacz Instrukcje: Dodawanie instrukcji śledzenia do kodu aplikacji.

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

Uwagi

Właściwości i metody w Trace klasie można użyć do instrumentowania kompilacji wydania. Instrumentacja umożliwia monitorowanie kondycji aplikacji działającej w ustawieniach rzeczywistych. Śledzenie pomaga wyizolować problemy i rozwiązywać je bez zakłócania działającego systemu.

Ta klasa udostępnia metody wyświetlania okna dialogowego Assert i emitowania asercji, która zawsze Failbędzie . Ta klasa udostępnia metody zapisu w następujących odmianach:

• Write
• WriteLine
• WriteIf
• WriteLineIf

Klasy BooleanSwitch i TraceSwitch zapewniają metody dynamicznego kontrolowania danych wyjściowych śledzenia. W aplikacjach platformy .NET Framework można modyfikować wartości tych przełączników bez ponownego komplikowania aplikacji. Aby uzyskać informacje na temat ustawiania przełącznika w aplikacji .NET Framework, zobacz klasę Switch i Jak utworzyć, zainicjować i skonfigurować przełączniki śledzenia.

Element docelowy śledzenia można dostosować, dodając TraceListener wystąpienia do kolekcji lub usuwając je.Listeners Kolekcja Listeners jest współużytkowany przez klasy Debug i Trace ; dodanie odbiornika śledzenia do jednej z klas dodaje odbiornik do obu tych klas. Domyślnie dane wyjściowe śledzenia są emitowane przy użyciu DefaultTraceListener klasy .

Klasa Trace udostępnia właściwości umożliwiające uzyskanie lub ustawienie poziomu parametru IndentIndentSizei oraz określa, czy ma to miejsce AutoFlush po każdym zapisie.

W aplikacjach .NET Framework można ustawić AutoFlush i IndentSize dla Trace, edytując plik konfiguracji odpowiadający nazwie aplikacji. Plik konfiguracji powinien być sformatowany tak jak w poniższym przykładzie:

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

Atrybut ConditionalAttribute jest stosowany do metod Trace. Kompilatory, które obsługują ConditionalAttribute ignorowanie wywołań do tych metod, chyba że TRACE jest zdefiniowany jako symbol kompilacji warunkowej. Zapoznaj się z dokumentacją kompilatora, aby określić, czy ConditionalAttribute jest obsługiwana, oraz składnia definiowania symbolu kompilacji warunkowej.

Aby zdefiniować TRACE symbol kompilacji warunkowej w języku C#, dodaj /d:TRACE opcję do wiersza polecenia kompilatora podczas kompilowania kodu przy użyciu wiersza polecenia lub dodaj #define TRACE go na początku pliku. W języku Visual Basic dodaj /d:TRACE=True opcję do wiersza polecenia kompilatora lub dodaj #Const TRACE=True go do pliku.

ConditionalAttribute nie jest obsługiwany przez kompilator języka C++. Aby zapewnić równoważną funkcjonalność, należy ująć wywołania metod Trace w #if defined(TRACE) ... #endif bloku i dodać /DTRACE opcję do wiersza polecenia kompilatora lub dodać #define TRACE do pliku.

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny wątkiem.

Zobacz też

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