Debug Sınıf

Tanım

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

Devralma

Object

Debug

Örnekler

Aşağıdaki örnek, Debug bir program yürütmenin başlangıcını ve sonunu göstermek için kullanır.The following example uses Debug to indicate the beginning and end of a program's execution. Örnek ayrıca Indent Unindent izleme çıkışını ayırt etmek için ve kullanır.The example also uses Indent and Unindent to distinguish the tracing output.

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

Açıklamalar

DebugSınıfında hata ayıklama bilgilerini yazdırmak ve mantığınızı denetlemek için yöntemler kullanırsanız, sevk ürününüzün performansını ve kod boyutunu etkilemeden kodunuzun daha sağlam olmasını sağlayabilirsiniz.If you use methods in the Debug class to print debugging information and check your logic with assertions, you can make your code more robust without impacting the performance and code size of your shipping product.

Bu sınıf Assert , bir iletişim kutusu görüntüleme ve her zaman başarısız olacak bir onaylama yayma için yöntemler sağlar.This class provides methods to display an Assert dialog box, and to emit an assertion that will always fail. Bu sınıf, aşağıdaki çeşitlemelerdeki yazma yöntemleri sağlar Write : WriteLine , WriteIf ve WriteLineIf .This class provides write methods in the following variations: Write, WriteLine, WriteIf and WriteLineIf.

BooleanSwitchVe TraceSwitch sınıfları, izleme çıkışını dinamik olarak denetlemek için araçlar sağlar.The BooleanSwitch and TraceSwitch classes provide means to dynamically control the tracing output. Uygulamanızı yeniden derlemeden bu anahtarların değerlerini değiştirebilirsiniz.You can modify the values of these switches without recompiling your application. Anahtar ayarlamak için yapılandırma dosyasını kullanma hakkında daha fazla bilgi için Switch sınıfı ve izleme anahtarları konusuna bakın.For information on using the configuration file to set a switch, see the Switch class and the Trace Switches topic.

Koleksiyona örnek ekleyerek TraceListener veya koleksiyondan örnek kaldırarak izleme çıktısının hedefini özelleştirebilirsiniz Listeners .You can customize the tracing output's target by adding TraceListener instances to or removing instances from the Listeners collection. ListenersKoleksiyon hem hem de sınıfları tarafından paylaşılır Debug Trace ; her iki sınıfa bir izleme dinleyicisi eklemek dinleyiciyi her ikisine de ekler.The Listeners collection is shared by both the Debug and the Trace classes; adding a trace listener to either class adds the listener to both. Varsayılan olarak, DefaultTraceListener sınıfı izleme çıkışını yayar.By default, the DefaultTraceListener class emits trace output.

Girinti düzeyini Indent yöntemini veya özelliğini kullanarak değiştirebilirsiniz IndentLevel .You can modify the level of indentation using the Indent method or the IndentLevel property. Girinti aralığını değiştirmek için IndentSize özelliğini kullanın.To modify the indent spacing, use the IndentSize property. Özelliğini olarak ayarlayarak, her yazma işleminden sonra çıkış arabelleğinin otomatik olarak temizlenip temizlenmeyeceğini belirtebilirsiniz AutoFlush true .You can specify whether to automatically flush the output buffer after each write by setting the AutoFlush property to true.

AutoFlushVe için ayarlamak için IndentSize Debug uygulamanızın adına karşılık gelen yapılandırma dosyasını düzenleyebilirsiniz.To set the AutoFlush and IndentSize for Debug, you can edit the configuration file corresponding to the name of your application. Yapılandırma dosyası, aşağıdaki örnekte gösterildiği gibi biçimlendirilmelidir.The configuration file should be formatted as shown in the following example.

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

ConditionalAttributeÖzniteliği, yöntemlerine uygulanır Debug .The ConditionalAttribute attribute is applied to the methods of Debug. ConditionalAttribute"Hata ayıklama" bir koşullu derleme sembolü olarak tanımlanmadığı sürece bu yöntemlere yönelik çağrıları yoksay 'ı destekleyen derleyiciler.Compilers that support ConditionalAttribute ignore calls to these methods unless "DEBUG" is defined as a conditional compilation symbol. ConditionalAttributeDesteklenip desteklenmediğini ve koşullu derleme sembolünü tanımlamaya yönelik sözdizimini öğrenmek için bir derleyicinin belgelerine bakın.Refer to a compiler's documentation to determine whether ConditionalAttribute is supported and the syntax for defining a conditional compilation symbol.

C# ' de "hata AYıKLA" koşullu derleme sembolünü tanımlamak için, /d:DEBUG bir komut satırı kullanarak kodunuzu derlerken derleyici komut satırına seçeneği ekleyin veya #define DEBUG dosyanızın en üstüne ekleyin.To define the "DEBUG" conditional compilation symbol in C#, add the /d:DEBUG option to the compiler command line when you compile your code using a command line, or add #define DEBUG to the top of your file. Visual Basic, /d:DEBUG=True derleyici komut satırına seçeneği ekleyin veya #Const DEBUG=True dosyaya ekleyin.In Visual Basic, add the /d:DEBUG=True option to the compiler command line or add #Const DEBUG=True to the file.

Özellikler

Yöntemler

Şunlara uygulanır

İş Parçacığı Güvenliği

Bu güvenli iş parçacığı türüdür.This type is thread safe.

Ayrıca bkz.

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