Trace.Fail 方法

  • 參考

定義

命名空間:
System.Diagnostics
組件:
System.Diagnostics.TraceSource.dll
組件:
System.dll
組件:
netstandard.dll

發出錯誤訊息。

多載

Fail(String)

發出指定的錯誤訊息。
Fail(String, String)

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

Fail(String)

發出指定的錯誤訊息。

public:
 static void Fail(System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public static void Fail (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^ ) 
{
   #if defined(TRACE)
   Trace::Fail( "Unknown Option " + option + ", using the default." );
   #endif
}

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:
      #if defined(TRACE)
      Trace::Fail(String::Format("Unknown Option {0}", option));
      #endif
      result = 1.0;
      break;
}

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 。 DefaultTraceListener如果 不在集合中 Listeners ，則不會顯示訊息方塊。 DefaultTraceListener可以透過 < 清除 > 、 < 移除 > 或呼叫 Clear 屬性 System.Diagnostics.Trace.Listeners.Clear() 上的 Listeners 方法來移除 ， () 。

您可以藉由將 加入至 TraceListener 集合，或從集合中移除其中一個 Listeners ，來自訂此行為。

另請參閱

適用於

Fail(String, String)

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

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")]
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^ ) 
{
  #if defined(TRACE)
  Trace::Fail( String::Format( "Invalid value: {0}", value ),
      "Resetting value to newValue." );
   #endif
   value = newValue;
}

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:
      #if defined(TRACE)
      Trace::Fail( String::Format( "Unsupported option {0}", option ),
         "Result set to 1.0" );
      #endif
      result = 1.0;
      break;
}

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 至訊息方塊，以及輸出至 TraceListener 集合中的 Listeners detailedMessage 實例。

注意

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

您可以藉由將 加入至 TraceListener 集合，或從集合中移除其中一個 Listeners ，來自訂此行為。

另請參閱

適用於