Trace Klass

Definition

public ref class Trace sealed

public sealed class Trace

type Trace = class

Public NotInheritable Class Trace

Arv

Object

Trace

Exempel

I följande exempel används Trace för att ange början och slutet av ett programs körning. I exemplet används Trace.Indent även metoderna och Trace.Unindent för att särskilja spårningsutdata. Ett mer komplett exempel på användningen av Tracefinns i How to: Add Trace Statements to Application Code (Så här lägger du till spårningsuttryck i Programkod).

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

Kommentarer

Du kan använda egenskaperna och metoderna i Trace klassen för att instrumentera versionsversioner. Med instrumentering kan du övervaka hälsotillståndet för ditt program som körs i verkliga inställningar. Spårning hjälper dig att isolera problem och åtgärda dem utan att störa ett system som körs.

Den här klassen innehåller metoder för att visa en Assert dialogruta och för att generera en försäkran som alltid Failkommer att . Den här klassen innehåller skrivmetoder i följande varianter:

• Write
• WriteLine
• WriteIf
• WriteLineIf

Klasserna BooleanSwitch och TraceSwitch ger möjlighet att dynamiskt kontrollera spårningsutdata. I .NET Framework-appar kan du ändra värdena för dessa växlar utan att kompilera om ditt program. Information om hur du använder konfigurationsfilen för att ange en växel i en .NET Framework-app finns i klassen Switch och How to: Create, Initialize, and Configure Trace Switchs.

Du kan anpassa spårningsutdatans mål genom att lägga till TraceListener instanser i eller ta bort instanser från Listeners samlingen. Samlingen Listeners delas av både klasserna Debug och Trace . Om du lägger till en spårningslyssnare i någon av klasserna läggs lyssnaren till i båda. Som standard genereras spårningsutdata med hjälp av DefaultTraceListener -klassen.

Klassen Trace innehåller egenskaper för att hämta eller ange nivån Indent för och IndentSize, och om AutoFlush till efter varje skrivning.

I .NET Framework-appar kan du ange AutoFlush och IndentSize för Trace genom att redigera konfigurationsfilen som motsvarar namnet på ditt program. Konfigurationsfilen ska formateras som i följande exempel:

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

Attributet ConditionalAttribute tillämpas på metoderna Traceför . Kompilatorer som stöder ConditionalAttribute ignorerar anrop till dessa metoder om de inte TRACE definieras som en villkorsstyrd kompileringssymbol. Se dokumentationen för en kompilator för att avgöra om ConditionalAttribute stöds och syntaxen för att definiera en villkorsstyrd kompileringssymbol.

Om du vill definiera symbolen TRACE för villkorsstyrd kompilering i C# lägger du till /d:TRACE alternativet på kommandoraden för kompilatorn när du kompilerar koden med hjälp av en kommandorad eller lägger till #define TRACE överst i filen. I Visual Basic lägger du till alternativet /d:TRACE=True på kommandoraden för kompilatorn eller lägger till #Const TRACE=True i filen.

ConditionalAttribute stöds inte av C++-kompilatorn. För att tillhandahålla motsvarande funktioner måste du omsluta anrop till metoderna Trace för i ett #if defined(TRACE) ... #endif block och lägga till /DTRACE alternativet på kommandoraden för kompilatorn eller lägga till #define TRACE i filen.

Trådsäkerhet

Den här typen är trådsäker.

Se även

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