Trace.Fail 方法

定義

命名空間:

System.Diagnostics

組件:

netstandard.dll, System.Diagnostics.TraceSource.dll

會發出錯誤訊息。

多載

名稱	Description
Fail(String)	會發出指定的錯誤訊息。
Fail(String, String)	會發出錯誤訊息，以及詳細的錯誤訊息。

Fail(String)

來源:

Trace.cs

會發出指定的錯誤訊息。

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

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

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

Public Shared Sub Fail (message As String)

參數

message

String

一個要發出的訊息。

屬性

ConditionalAttribute

範例

以下範例使用了 Fail 在例外處理期間列印訊息的方法。

catch (Exception)
{
    Trace.Fail("Unknown Option " + option + ", using the default.");
}

Catch
    Trace.Fail("Unknown Option " + option1 + ", using the default.")
End Try

你也可以在 switch 語句中使用這個 Fail 方法。

switch (option)
{
    case Option.First:
        result = 1.0;
        break;

    // Insert additional cases.
    default:
        Trace.Fail("Unknown Option " + option);
        result = 1.0;
        break;
}

Select Case option1
    Case OptionConsts.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Trace.Fail(("Unknown Option " & option1))
        result = 1.0
End Select

備註

預設追蹤監聽器的預設行為是，當應用程式以使用者介面模式執行時，會將參數輸出到訊息框，並將參數輸出 message 到 TraceListener 集合中的 Listeners 實例。

備註

訊息框的顯示取決於 的存在 DefaultTraceListener。 如果不在Listeners集合中，DefaultTraceListener訊息框就不會顯示。 DefaultTraceListener可透過清除<>、<移除>，或在屬性System.Diagnostics.Trace.Listeners.Clear()（）上呼叫Clear方法Listeners來移除。

你可以透過新增一個 TraceListener 到集合或移除一個 Listeners 來自訂這個行為。

另請參閱

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

Fail(String, String)

來源:

Trace.cs

會發出錯誤訊息，以及詳細的錯誤訊息。

public:
 static void Fail(System::String ^ message, System::String ^ detailMessage);

[System.Diagnostics.Conditional("TRACE")]
public static void Fail(string? message, string? detailMessage);

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

Public Shared Sub Fail (message As String, detailMessage As String)

參數

message

String

一個要發出的訊息。

detailMessage

String

要發出一則詳細訊息。

屬性

ConditionalAttribute

範例

以下範例使用了 Fail 在例外處理期間列印訊息的方法。

catch (Exception)
{
    Trace.Fail("Invalid value: " + value.ToString(),
       "Resetting value to newValue.");
    value = newValue;
}

Catch
    Trace.Fail("Invalid value: " & value.ToString(), _
        "Resetting value to newValue.")
    value = newValue
End Try

你也可以在 switch 語句中使用這個 Fail 方法。

switch (option)
{
    case Option.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Trace.Fail("Unsupported option " + option, "Result set to 1.0");
        result = 1.0;
        break;
}

Select Case option1
    Case OptionConsts.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Trace.Fail("Unsupported option " & option1, "Result set to 1.0")
        result = 1.0
End Select

備註

預設行為是，當應用程式在使用者介面模式下執行時，預設追蹤監聽器會輸出 message 參數及 detailedMessage 參數到訊息框，並輸出到 TraceListener 集合中的 Listeners 實例。

備註

訊息框的顯示取決於 的存在 DefaultTraceListener。 如果不在Listeners集合中，DefaultTraceListener訊息框就不會顯示。 DefaultTraceListener可透過清除<>、<移除>，或在屬性System.Diagnostics.Trace.Listeners.Clear()（）上呼叫Clear方法Listeners來移除。

你可以透過新增一個 TraceListener 到集合或移除一個 Listeners 來自訂這個行為。

另請參閱

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