Debug.WriteLine Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestawy:

netstandard.dll, System.Runtime.dll

Zapisuje informacje o debugowaniu do odbiorników śledzenia w kolekcji Listeners .

Przeciążenia

Nazwa	Opis
WriteLine(String, String)	Zapisuje nazwę kategorii i komunikat do odbiorników śledzenia w kolekcji Listeners .
WriteLine(String, Object[])	Zapisuje sformatowany komunikat, po którym następuje terminator wierszy do odbiorników śledzenia w Listeners kolekcji.
WriteLine(String)	Zapisuje komunikat, po którym następuje terminator wiersza do odbiorników śledzenia w Listeners kolekcji.
WriteLine(Object)	Zapisuje wartość metody obiektu ToString() dla odbiorników śledzenia w kolekcji Listeners .
WriteLine(Object, String)	Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiorników śledzenia w Listeners kolekcji.

WriteLine(String, String)

Źródło:

Debug.cs

Zapisuje nazwę kategorii i komunikat do odbiorników śledzenia w kolekcji Listeners .

public:
 static void WriteLine(System::String ^ message, System::String ^ category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine(string? message, string? category);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLine : string * string -> unit

Public Shared Sub WriteLine (message As String, category As String)

Parametry

message

String

Wiadomość do zapisu.

category

String

Nazwa kategorii używana do organizowania danych wyjściowych.

Atrybuty

ConditionalAttribute

Przykłady

W poniższym przykładzie zostanie utworzona nazwana TraceSwitch.generalSwitch Ten przełącznik jest ustawiony poza przykładem kodu.

Jeśli przełącznik jest ustawiony na TraceLevelError lub wyższy, przykład zwraca pierwszy komunikat o błędzie do Listeners. Aby uzyskać informacje na temat dodawania odbiornika do Listeners kolekcji, zobacz klasę TraceListenerCollection .

Następnie, jeśli TraceLevel parametr ma wartość Verbose, przykład zwraca drugi komunikat o błędzie i w category tym samym wierszu co pierwszy komunikat. Terminator wiersza jest zgodny z drugim komunikatem.

// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(string category)
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    if (generalSwitch.TraceError)
        Debug.Write("My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if (generalSwitch.TraceVerbose)
        Debug.WriteLine("My second error message.", category);
}

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(category As String)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If generalSwitch.TraceError Then
        Debug.Write("My error message. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Debug.WriteLine("My second error message.", category)
    End If
End Sub

Uwagi

Domyślnie dane wyjściowe są zapisywane w wystąpieniu DefaultTraceListenerklasy .

Parametr category może służyć do grupowania komunikatów wyjściowych.

Ta metoda wywołuje metodę WriteLine odbiornika śledzenia.

Zobacz też

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

WriteLine(String, Object[])

Źródło:

Debug.cs

Zapisuje sformatowany komunikat, po którym następuje terminator wierszy do odbiorników śledzenia w Listeners kolekcji.

public:
 static void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine(string format, params object?[] args);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLine : string * obj[] -> unit

Public Shared Sub WriteLine (format As String, ParamArray args As Object())

Parametry

format

String

Ciąg formatu złożonego, który zawiera tekst mieszany z zero lub więcej elementów formatu, które odpowiadają obiektom w tablicy args.

args

Object[]

Tablica obiektów zawierająca zero lub więcej obiektów do sformatowania.

Atrybuty

ConditionalAttribute

Uwagi

Ta metoda używa funkcji formatowania złożonego platformy .NET , aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w ciągu.

Słowo kluczowe params (w języku C#) lub ParamArray (w Visual Basic) w składni tej metody oznacza, że tablica obiektów może być pojedynczą wartością. Wyjątkiem od tego jest String obiekt. Jawne przeciążenia mają pierwszeństwo, więc arg wartość pojedynczego ciągu będzie domyślna Debug.WriteLine(String, String) dla przeciążenia.

Domyślnie dane wyjściowe są zapisywane w wystąpieniu DefaultTraceListenerklasy .

Ta metoda wywołuje metodę TraceListener.WriteLine odbiornika śledzenia.

WriteLine(String)

Źródło:

Debug.cs

Zapisuje komunikat, po którym następuje terminator wiersza do odbiorników śledzenia w Listeners kolekcji.

public:
 static void WriteLine(System::String ^ message);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine(string? message);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLine : string -> unit

Public Shared Sub WriteLine (message As String)

Parametry

message

String

Wiadomość do zapisu.

Atrybuty

ConditionalAttribute

Przykłady

W poniższym przykładzie zostanie utworzona nazwana TraceSwitch.generalSwitch Ten przełącznik jest ustawiony poza przykładem kodu.

Jeśli przełącznik jest ustawiony na TraceLevelError lub wyższy, przykład zwraca pierwszy komunikat o błędzie do Listeners. Aby uzyskać informacje na temat dodawania odbiornika do Listeners kolekcji, zobacz klasę TraceListenerCollection .

Następnie, jeśli TraceLevel parametr ma wartość Verbose, przykład zwraca drugi komunikat o błędzie w tym samym wierszu co pierwszy komunikat. Terminator wiersza jest zgodny z drugim komunikatem.

// Class-level declaration.
// Create a TraceSwitch.
TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static void MyErrorMethod()
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    if (generalSwitch.TraceError)
        Debug.Write("My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if (generalSwitch.TraceVerbose)
        Debug.WriteLine("My second error message.");
}

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod()
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If generalSwitch.TraceError Then
        Debug.Write("My error message. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Debug.WriteLine("My second error message.")
    End If
End Sub

Uwagi

Domyślnie dane wyjściowe są zapisywane w wystąpieniu DefaultTraceListenerklasy .

Ta metoda wywołuje metodę WriteLine odbiornika śledzenia.

Zobacz też

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

WriteLine(Object)

Źródło:

Debug.cs

Zapisuje wartość metody obiektu ToString() dla odbiorników śledzenia w kolekcji Listeners .

public:
 static void WriteLine(System::Object ^ value);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine(object? value);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLine : obj -> unit

Public Shared Sub WriteLine (value As Object)

Parametry

value

Object

Obiekt, którego nazwa jest wysyłana do obiektu Listeners.

Atrybuty

ConditionalAttribute

Przykłady

W poniższym przykładzie zostanie utworzona nazwana TraceSwitch.generalSwitch Ten przełącznik jest ustawiony poza przykładem kodu.

Jeśli przełącznik jest ustawiony na TraceLevelError lub wyższy, przykład zwraca pierwszy komunikat o błędzie do Listeners. Aby uzyskać informacje na temat dodawania odbiornika do Listeners kolekcji, zobacz klasę TraceListenerCollection .

Następnie, jeśli TraceLevel parametr ma wartość Verbose, przykład zwraca nazwę obiektu w tym samym wierszu co pierwszy komunikat. Terminator wiersza jest zgodny z drugim komunikatem.

// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(Object myObject)
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    if (generalSwitch.TraceError)
        Debug.Write("Invalid object. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if (generalSwitch.TraceVerbose)
        Debug.WriteLine(myObject);
}

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(myObject As Object)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If generalSwitch.TraceError Then
        Debug.Write("Invalid object. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Debug.WriteLine(myObject)
    End If
End Sub

Uwagi

Domyślnie dane wyjściowe są zapisywane w wystąpieniu DefaultTraceListenerklasy .

Ta metoda wywołuje metodę WriteLine odbiornika śledzenia.

Zobacz też

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

WriteLine(Object, String)

Źródło:

Debug.cs

Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiorników śledzenia w Listeners kolekcji.

public:
 static void WriteLine(System::Object ^ value, System::String ^ category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteLine(object? value, string? category);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteLine : obj * string -> unit

Public Shared Sub WriteLine (value As Object, category As String)

Parametry

value

Object

Obiekt, którego nazwa jest wysyłana do obiektu Listeners.

category

String

Nazwa kategorii używana do organizowania danych wyjściowych.

Atrybuty

ConditionalAttribute

Przykłady

W poniższym przykładzie zostanie utworzona nazwana TraceSwitch.generalSwitch Ten przełącznik jest ustawiony poza przykładem kodu.

Jeśli przełącznik jest ustawiony na TraceLevelError lub wyższy, przykład zwraca pierwszy komunikat o błędzie do Listeners. Aby uzyskać informacje na temat dodawania odbiornika do Listeners kolekcji, zobacz klasę TraceListenerCollection .

Następnie, jeśli TraceLevel parametr ma wartość Verbose, przykład zwraca drugi komunikat o błędzie w tym samym wierszu co pierwszy komunikat. Po drugim komunikacie następuje terminator wiersza.

// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(Object myObject, string category)
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    if (generalSwitch.TraceError)
        Debug.Write("Invalid object for category. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    if (generalSwitch.TraceVerbose)
        Debug.WriteLine(myObject, category);
}

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(myObject As Object, category As String)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    If generalSwitch.TraceError Then
        Debug.Write("Invalid object for category. ")
    End If 
    ' Write a second message if the TraceSwitch level is set to Verbose.
    If generalSwitch.TraceVerbose Then
        Debug.WriteLine(myObject, category)
    End If
End Sub

Uwagi

Domyślnie dane wyjściowe są zapisywane w wystąpieniu DefaultTraceListenerklasy .

Parametr category może służyć do grupowania komunikatów wyjściowych.

Ta metoda wywołuje metodę WriteLine odbiornika śledzenia.

Zobacz też

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute