Debug Класс

Определение

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

Наследование

Object

Debug

Примеры

В следующем примере используется Debug для указания начала и окончания выполнения программы. В примере также используется Indent и Unindent для различения выходных данных трассировки.

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

Комментарии

Чтобы сделать код более надежным, не влияя на производительность и размер продукта доставки, используйте методы в Debug классе для печати отладочные сведения и проверка логику с утверждениями.

Этот класс предоставляет методы для отображения диалогового Assert окна и для создания утверждения, которое всегда будет завершать ошибку. Этот класс предоставляет методы записи в следующих вариантах:

• Write
• WriteLine
• WriteIf
• WriteLineIf

BooleanSwitch Классы и TraceSwitch предоставляют средства для динамического управления выходными данными трассировки. Для платформа .NET Framework приложений можно изменять значения этих параметров без перекомпиляции приложения. Сведения об использовании файла конфигурации для настройки коммутатора в платформа .NET Framework приложениях смSwitch. в разделе Класс и статью Параметры трассировки.

Вы можете настроить целевой объект вывода трассировки, добавив TraceListener экземпляры в коллекцию или удалив их из Listeners коллекции. Коллекция Listeners совместно используется как классами , Debug так и Trace классами ; добавление прослушивателя трассировки в любой класс добавляет прослушиватель к обоим классам. По умолчанию DefaultTraceListener класс выдает выходные данные трассировки.

Уровень отступа можно изменить с помощью Indent метода или IndentLevel свойства . Чтобы изменить интервал отступов, используйте IndentSize свойство . Можно указать, следует ли автоматически очищать выходной буфер после каждой записи, задав свойству AutoFlush значение true.

Для платформа .NET Framework приложений можно задать AutoFlush и IndentSize дляDebug, изменив файл конфигурации приложения. Файл конфигурации должен быть отформатирован, как показано в следующем примере.

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

Атрибут ConditionalAttribute применяется к методам .Debug Компиляторы, поддерживающие ConditionalAttribute , игнорируют вызовы этих методов, если DEBUG не определен как символ условной компиляции. Сведения о поддержке и синтаксисе для определения символа условной компиляции см. в документации ConditionalAttribute компилятора.

Чтобы определить символ условной DEBUG компиляции в C#, добавьте /d:DEBUG параметр в командную строку компилятора при компиляции кода с помощью командной строки или добавьте #define DEBUG в начало файла. В Visual Basic добавьте параметр в /d:DEBUG=True командную строку компилятора или в #Const DEBUG=True файл .

Свойства

Методы

Применяется к

Потокобезопасность

Данный тип потокобезопасен.

См. также раздел

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