Debug.WriteLine 方法

定義

命名空間:

System.Diagnostics

組件:

System.Runtime.dll

將偵錯的相關信息寫入至 Listeners 集合中的追蹤接聽程式。

多載

WriteLine(String, String)	將類別名稱和訊息寫入至 Listeners 集合中的追蹤接聽程式。
WriteLine(String, Object[])	將格式化的訊息，後面接著行終止符寫入至 Listeners 集合中的追蹤接聽項。
WriteLine(String)	將訊息後面接著行終止符寫入至 Listeners 集合中的追蹤接聽程式。
WriteLine(Object)	將物件的 ToString() 方法值寫入至 Listeners 集合中的追蹤接聽程式。
WriteLine(Object, String)	將類別名稱和物件的 ToString() 方法值寫入至 Listeners 集合中的追蹤接聽程式。

WriteLine(String, String)

來源:

Debug.cs

將類別名稱和訊息寫入至 Listeners 集合中的追蹤接聽程式。

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

參數

message

String

要寫入的訊息。

category

String

用來組織輸出的類別名稱。

屬性

ConditionalAttribute

範例

下列範例會建立名為 generalSwitchTraceSwitch。 這個參數是在程式碼範例之外設定的。

如果參數設定為 TraceLevelError 或更高版本，則此範例會將第一個錯誤訊息輸出至 Listeners。 如需將接聽程式新增至 Listeners 集合的詳細資訊，請參閱 TraceListenerCollection 類別。

然後，如果 TraceLevel 設定為 Verbose，則此範例會輸出第二個錯誤訊息，並在與第一則訊息相同的行上輸出 category。 行終止符遵循第二則訊息。

// 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);
}

備註

根據預設，輸出會寫入 DefaultTraceListener實例。

category 參數可用來將輸出訊息分組。

這個方法會呼叫追蹤接聽程式的 WriteLine 方法。

另請參閱

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

WriteLine(String, Object[])

來源:

Debug.cs

將格式化的訊息，後面接著行終止符寫入至 Listeners 集合中的追蹤接聽項。

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

參數

format

String

複合格式字串，其中包含與零個或多個格式專案混雜的文字，對應至 args 陣列中的物件。

args

Object[]

對象陣列，其中包含要格式化的零個或多個物件。

屬性

ConditionalAttribute

備註

這個方法會使用 .NET 複合格式功能，將物件的值轉換成其文字表示法，並將該表示法內嵌在字串中。

此方法語法中的 參數（C#） 或 ParamArray 關鍵詞表示物件數位可以是單一值。 例外狀況是 String 物件。 明確多載的優先順序，因此單一字串的 arg 值預設為 Debug.WriteLine(String, String) 多載。

根據預設，輸出會寫入 DefaultTraceListener實例。

這個方法會呼叫追蹤接聽程式的 TraceListener.WriteLine 方法。

WriteLine(String)

來源:

Debug.cs

將訊息後面接著行終止符寫入至 Listeners 集合中的追蹤接聽程式。

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

參數

message

String

要寫入的訊息。

屬性

ConditionalAttribute

範例

下列範例會建立名為 generalSwitchTraceSwitch。 這個參數是在程式碼範例之外設定的。

如果參數設定為 TraceLevelError 或更高版本，則此範例會將第一個錯誤訊息輸出至 Listeners。 如需將接聽程式新增至 Listeners 集合的詳細資訊，請參閱 TraceListenerCollection 類別。

然後，如果 TraceLevel 設定為 Verbose，則此範例會在與第一個訊息相同的行上輸出第二個錯誤訊息。 行終止符遵循第二則訊息。

// 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.");
}

備註

根據預設，輸出會寫入 DefaultTraceListener實例。

這個方法會呼叫追蹤接聽程式的 WriteLine 方法。

另請參閱

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

WriteLine(Object)

來源:

Debug.cs

將物件的 ToString() 方法值寫入至 Listeners 集合中的追蹤接聽程式。

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

參數

value

Object

物件，其名稱會傳送至 Listeners。

屬性

ConditionalAttribute

範例

下列範例會建立名為 generalSwitchTraceSwitch。 這個參數是在程式碼範例之外設定的。

如果參數設定為 TraceLevelError 或更高版本，則此範例會將第一個錯誤訊息輸出至 Listeners。 如需將接聽程式新增至 Listeners 集合的詳細資訊，請參閱 TraceListenerCollection 類別。

然後，如果 TraceLevel 設定為 Verbose，則此範例會在與第一則訊息相同的行輸出物件名稱。 行終止符遵循第二則訊息。

// 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);
}

備註

根據預設，輸出會寫入 DefaultTraceListener實例。

這個方法會呼叫追蹤接聽程式的 WriteLine 方法。

另請參閱

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

WriteLine(Object, String)

來源:

Debug.cs

將類別名稱和物件的 ToString() 方法值寫入至 Listeners 集合中的追蹤接聽程式。

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

參數

value

Object

物件，其名稱會傳送至 Listeners。

category

String

用來組織輸出的類別名稱。

屬性

ConditionalAttribute

範例

下列範例會建立名為 generalSwitchTraceSwitch。 這個參數是在程式碼範例之外設定的。

如果參數設定為 TraceLevelError 或更高版本，則此範例會將第一個錯誤訊息輸出至 Listeners。 如需將接聽程式新增至 Listeners 集合的詳細資訊，請參閱 TraceListenerCollection 類別。

然後，如果 TraceLevel 設定為 Verbose，則此範例會在與第一個訊息相同的行上輸出第二個錯誤訊息。 第二則訊息後面接著行終止符。

// 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);
}

備註

根據預設，輸出會寫入 DefaultTraceListener實例。

category 參數可用來將輸出訊息分組。

這個方法會呼叫追蹤接聽程式的 WriteLine 方法。

另請參閱

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