Debug Klass

Definition

public ref class Debug abstract sealed

public ref class Debug sealed

public static class Debug

public sealed class Debug

type Debug = class

Public Class Debug

Public NotInheritable Class Debug

Arv

Object

Debug

Exempel

I följande exempel används Debug för att ange början och slutet av ett programs körning. Exemplet använder Indent också och Unindent för att särskilja spårningsutdata.

// Specify /d:DEBUG when compiling.

using System;
using System.Data;
using System.Diagnostics;

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

' Specify /d:DEBUG=True when compiling.

Imports System.Data
Imports System.Diagnostics

Class Test

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

Kommentarer

Om du vill göra koden mer robust utan att påverka leveransproduktens prestanda och kodstorlek använder du metoder i Debug klassen för att skriva ut felsökningsinformation och kontrollera logiken med försäkran.

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 misslyckas. 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. För .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 .NET Framework-appar finns i artikeln Switch och Trace Switches.

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 DefaultTraceListener genererar klassen spårningsutdata.

Du kan ändra indragsnivån med hjälp Indent av metoden eller IndentLevel egenskapen . Om du vill ändra indragsavståndet använder du IndentSize egenskapen . Du kan ange om utdatabufferten ska tömmas automatiskt efter varje skrivning genom att ange AutoFlush egenskapen till true.

För .NET Framework-appar kan du ange AutoFlush och IndentSize för Debug genom att redigera appens konfigurationsfil. Konfigurationsfilen ska formateras enligt följande exempel.

<configuration>
  <system.diagnostics>
    <trace autoflush="true" indentsize="7" />
  </system.diagnostics>
</configuration>

Attributet ConditionalAttribute tillämpas på metoderna Debugför . Kompilatorer som stöder ConditionalAttribute ignorerar anrop till dessa metoder om de inte DEBUG 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 DEBUG för villkorsstyrd kompilering i C# lägger du till /d:DEBUG alternativet på kommandoraden för kompilatorn när du kompilerar koden med hjälp av en kommandorad eller lägger till #define DEBUG överst i filen. I Visual Basic lägger du till alternativet /d:DEBUG=True på kommandoraden för kompilatorn eller lägger till #Const DEBUG=True i filen.

Trådsäkerhet

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

Se även

• Trace
• Switch
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TraceListenerCollection
• ConditionalAttribute