Debug Třída

Definice

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

Dědičnost

Object

Debug

Příklady

Následující příklad používá Debug k označení začátku a konce provádění programu. Příklad také používá Indent a Unindent k odlišení výstupu trasování.

// Specify /DDEBUG when compiling.

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

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

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

Poznámky

Pokud chcete, aby váš kód byl robustnější, aniž by to mělo vliv na výkon a velikost kódu vašeho expedičního produktu, použijte metody ve Debug třídě k tisku informací o ladění a zkontrolujte logiku pomocí kontrolních výrazů.

Tato třída poskytuje metody zobrazení dialogového Assert okna a generování kontrolního výrazu, který vždy selže. 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í. U aplikací .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 aplikacích .NET Framework najdete Switch ve třídě a v článku Přepínače trasování .

Cíl výstupu trasování můžete přizpůsobit přidáním TraceListener instancí do kolekce nebo jejich odebráním Listeners . Kolekce Listeners je sdílena třídami a DebugTrace ; přidáním naslouchacího procesu trasování do obou tříd přidáte naslouchací proces do obou tříd. Ve výchozím nastavení DefaultTraceListener třída generuje výstup trasování.

Úroveň odsazení můžete upravit pomocí Indent metody nebo IndentLevel vlastnosti . Pokud chcete upravit odsazení, použijte IndentSize vlastnost . Nastavením vlastnosti na hodnotu můžete určit, jestli se má výstupní vyrovnávací paměť po každém zápisu automaticky vyprázdnit AutoFlushtrue.

Pro aplikace .NET Framework můžete nastavit AutoFlush a IndentSize pro Debug úpravou konfiguračního souboru aplikace. Konfigurační soubor by měl být formátovaný tak, jak je znázorněno v následujícím příkladu.

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

Atribut ConditionalAttribute se použije na metody nástroje Debug. Kompilátory, které podporují ConditionalAttribute , ignorují volání těchto metod, pokud DEBUG není definován 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 DEBUG symbol podmíněné kompilace v jazyce C#, přidejte /d:DEBUG možnost do příkazového řádku kompilátoru při kompilaci kódu pomocí příkazového řádku nebo přidání #define DEBUG na začátek souboru. V jazyce Visual Basic přidejte /d:DEBUG=True možnost do příkazového řádku kompilátoru nebo přidejte #Const DEBUG=True do souboru .

Vlastnosti

Metody

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é

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