Debug.Fail 方法

参考

定义

命名空间:: System.Diagnostics

程序集:: System.Diagnostics.Debug.dll

程序集:: System.Runtime.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

发出一条错误消息。

重载

Fail(String, String)	发出错误消息及详细的错误消息。
Fail(String)	发出指定的错误消息。

Fail(String, String)

Source:: Debug.cs

Source:: Debug.cs

Source:: 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")]
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>、remove 或调用属性上的方法 () 来删除< 。><System.Diagnostics.Trace.Listeners.Clear()Listeners Clear

可以通过向集合添加 TraceListener 或从 Listeners 集合中删除来自定义此行为。

另请参阅

适用于

Fail(String)

Source:: Debug.cs

Source:: Debug.cs

Source:: Debug.cs

发出指定的错误消息。

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

[System.Diagnostics.Conditional("DEBUG")]
public static void Fail (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