Debug.Fail 方法

定義

命名空間:

System.Diagnostics

組件:

System.Runtime.dll

發出錯誤訊息。

多載

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

Fail(String, String)

來源:

Debug.cs

發出錯誤訊息和詳細錯誤訊息。

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

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

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

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

參數

message

String

要發出的訊息。

detailMessage

String

要發出的詳細訊息。

屬性

ConditionalAttribute

範例

下列範例會 Fail 使用 方法在例外狀況處理期間列印訊息。

catch ( Exception^ e ) 
{
   #if defined(DEBUG)
   Debug::Fail( "Cannot find SpecialController, proceeding with StandardController", "Setting Controller to default value" );
   #endif
}

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

Catch e As Exception
    Debug.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(DEBUG)
         Debug::Fail( "Unknown Option" + option, "Result set to 1.0" );
         #endif
         result = 1.0;
         break;
   }

switch (option1)
{
    case MyOption.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Debug.Fail("Unknown Option " + option1, "Result set to 1.0");
        result = 1.0;
        break;
}

Select Case option1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail("Unknown Option " & option1, "Result set to 1.0")
        result = 1.0
End Select

備註

默認行為是在 DefaultTraceListener 應用程式以使用者介面模式執行時，將訊息輸出至消息框，以及輸出至 TraceListener 集合中的 Listeners 實例。

注意

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

您可以藉由在集合中加入 TraceListener 或移除一個 Listeners ，來自定義此行為。

另請參閱

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

Fail(String)

來源:

Debug.cs

發出指定的錯誤訊息。

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

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

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

Public Shared Sub Fail (message As String)

參數

message

String

要發出的訊息。

屬性

ConditionalAttribute

範例

下列範例會 Fail 使用 方法在例外狀況處理期間列印訊息。

catch ( Exception^ e ) 
{
   #if defined(DEBUG)
   Debug::Fail( "Unknown Option " + option + ", using the default." );
   #endif
}

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

Catch e As Exception
    Debug.Fail("Unknown Option " + myOption1 + ", using the default.")
End Try

您也可以在 switch 語句中使用 Fail 方法。

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

      // Insert additional cases.
      
      default:
         #if defined(DEBUG)
         Debug::Fail( "Unknown Option" + option );
         #endif
         result = 1.0;
         break;
   }

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

    // Insert additional cases.

    default:
        Debug.Fail("Unknown Option " + option);
        result = 1.0;
        break;
}

Select Case myOption1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail(("Unknown Option " & myOption1.ToString))
        result = 1.0
End Select

備註

默認行為是在 DefaultTraceListener 應用程式以使用者介面模式執行時，將訊息輸出至消息框，以及輸出至 TraceListener 集合中的 Listeners 實例。

注意

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

您可以藉由在集合中加入 TraceListener 或移除一個 Listeners ，來自定義此行為。

另請參閱

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