Debug.WriteLine Metódus

Definíció

Névtér:

System.Diagnostics

Szerelvények:

netstandard.dll, System.Runtime.dll

Adatokat ír a hibakeresésről a gyűjtemény nyomkövetési figyelőinek Listeners .

Túlterhelések

Name	Description
WriteLine(String, String)	Kategórianevet és üzenetet ír a gyűjtemény nyomkövetési figyelőinek Listeners .
WriteLine(String, Object[])	Formázott üzenetet ír, amelyet egy sor terminátor követ a gyűjtemény nyomkövetési Listeners figyelőinek.
WriteLine(String)	Egy üzenetet ír, amelyet egy sor terminátor követ a gyűjtemény nyomkövetési figyelőinek Listeners .
WriteLine(Object)	Az objektum ToString() metódusának értékét a gyűjtemény nyomkövetési figyelőinek Listeners írja.
WriteLine(Object, String)	Kategórianevet és az objektum ToString() metódusának értékét írja a gyűjtemény nyomkövetési Listeners figyelőinek.

WriteLine(String, String)

Forrás:

Debug.cs

Kategórianevet és üzenetet ír a gyűjtemény nyomkövetési figyelőinek 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)

Paraméterek

message

String

Egy írandó üzenet.

category

String

A kimenet rendszerezéséhez használt kategórianév.

Attribútumok

ConditionalAttribute

Példák

Az alábbi példa létrehoz egy TraceSwitch elnevezettet generalSwitch. Ez a kapcsoló a kódmintán kívül van beállítva.

Ha a kapcsoló a magasabbra van állítva TraceLevelError , a példa az első hibaüzenetet adja ki a Listeners. A figyelő gyűjteményhez való Listeners hozzáadásáról további információt az TraceListenerCollection osztályban talál.

Ezután, ha a TraceLevel be van állítva Verbose, a példa a második hibaüzenetet és az category első üzenettel megegyező sorban adja ki. A sor terminátora a második üzenetet követi.

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

Megjegyzések

Alapértelmezés szerint a kimenet a következő példányra DefaultTraceListenerlesz megírva: .

A category paraméter használható a kimeneti üzenetek csoportosítására.

Ez a metódus meghívja a WriteLine nyomkövetési figyelő metódusát.

Lásd még

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

WriteLine(String, Object[])

Forrás:

Debug.cs

Formázott üzenetet ír, amelyet egy sor terminátor követ a gyűjtemény nyomkövetési Listeners figyelőinek.

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())

Paraméterek

format

String

Olyan összetett formázási sztring, amely a tömb objektumainak args megfelelő, nulla vagy több formázási elemekkel összefűzött szöveget tartalmaz.

args

Object[]

Olyan objektumtömb, amely nulla vagy több formázandó objektumot tartalmaz.

Attribútumok

ConditionalAttribute

Megjegyzések

Ez a metódus az .NET összetett formázási funkciót használja az objektum értékének szövegreformálásra való konvertálásához, majd a sztringbe való beágyazáshoz.

A params (C#-ban) vagy ParamArray (Visual Basic) kulcsszó azt jelenti, hogy az objektumtömb egyetlen érték lehet. Ez alól kivételt képez az String objektum. Az explicit túlterhelések elsőbbséget élveznek, ezért egy sztring arg értéke alapértelmezés szerint a Debug.WriteLine(String, String) túlterhelésre lesz alapértelmezett.

Alapértelmezés szerint a kimenet a következő példányra DefaultTraceListenerlesz megírva: .

Ez a metódus meghívja a TraceListener.WriteLine nyomkövetési figyelő metódusát.

WriteLine(String)

Forrás:

Debug.cs

Egy üzenetet ír, amelyet egy sor terminátor követ a gyűjtemény nyomkövetési figyelőinek Listeners .

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)

Paraméterek

message

String

Egy írandó üzenet.

Attribútumok

ConditionalAttribute

Példák

Az alábbi példa létrehoz egy TraceSwitch elnevezettet generalSwitch. Ez a kapcsoló a kódmintán kívül van beállítva.

Ha a kapcsoló a magasabbra van állítva TraceLevelError , a példa az első hibaüzenetet adja ki a Listeners. A figyelő gyűjteményhez való Listeners hozzáadásáról további információt az TraceListenerCollection osztályban talál.

Ezután, ha a TraceLevel be van állítva Verbose, a példa a második hibaüzenetet az első üzenettel megegyező sorban adja ki. A sor terminátora a második üzenetet követi.

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

Megjegyzések

Alapértelmezés szerint a kimenet a következő példányra DefaultTraceListenerlesz megírva: .

Ez a metódus meghívja a WriteLine nyomkövetési figyelő metódusát.

Lásd még

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

WriteLine(Object)

Forrás:

Debug.cs

Az objektum ToString() metódusának értékét a gyűjtemény nyomkövetési figyelőinek Listeners írja.

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)

Paraméterek

value

Object

Egy objektum, amelynek a nevét a rendszer elküldi a Listeners.

Attribútumok

ConditionalAttribute

Példák

Az alábbi példa létrehoz egy TraceSwitch elnevezettet generalSwitch. Ez a kapcsoló a kódmintán kívül van beállítva.

Ha a kapcsoló a magasabbra van állítva TraceLevelError , a példa az első hibaüzenetet adja ki a Listeners. A figyelő gyűjteményhez való Listeners hozzáadásáról további információt az TraceListenerCollection osztályban talál.

Ezután, ha a TraceLevel beállítás Verboseértéke, a példa az objektum nevét adja ki az első üzenettel megegyező sorban. A sor terminátora a második üzenetet követi.

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

Megjegyzések

Alapértelmezés szerint a kimenet a következő példányra DefaultTraceListenerlesz megírva: .

Ez a metódus meghívja a WriteLine nyomkövetési figyelő metódusát.

Lásd még

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

WriteLine(Object, String)

Forrás:

Debug.cs

Kategórianevet és az objektum ToString() metódusának értékét írja a gyűjtemény nyomkövetési Listeners figyelőinek.

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)

Paraméterek

value

Object

Egy objektum, amelynek a nevét a rendszer elküldi a Listeners.

category

String

A kimenet rendszerezéséhez használt kategórianév.

Attribútumok

ConditionalAttribute

Példák

Az alábbi példa létrehoz egy TraceSwitch elnevezettet generalSwitch. Ez a kapcsoló a kódmintán kívül van beállítva.

Ha a kapcsoló a magasabbra van állítva TraceLevelError , a példa az első hibaüzenetet adja ki a Listeners. A figyelő gyűjteményhez való Listeners hozzáadásáról további információt az TraceListenerCollection osztályban talál.

Ezután, ha a TraceLevel be van állítva Verbose, a példa a második hibaüzenetet az első üzenettel megegyező sorban adja ki. A második üzenetet egy sor terminátor követi.

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

Megjegyzések

Alapértelmezés szerint a kimenet a következő példányra DefaultTraceListenerlesz megírva: .

A category paraméter használható a kimeneti üzenetek csoportosítására.

Ez a metódus meghívja a WriteLine nyomkövetési figyelő metódusát.

Lásd még

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