Debug.Fail 方法
定义
发出一条错误消息。Emits an error message.
重载
| Fail(String) |
发出指定的错误消息。Emits the specified error message. |
| Fail(String, String) |
发出错误消息及详细的错误消息。Emits an error message and a detailed error message. |
Fail(String)
发出指定的错误消息。Emits the specified error message.
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
static member Fail : string -> unit
Public Shared Sub Fail (message As String)
参数
- message
- String
要发出的消息。A message to emit.
- 属性
示例
下面的示例使用 Fail 方法在异常处理过程中打印消息。The following example uses the Fail method to print a message during exception handling.
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
你还可以 Fail 在 switch 语句中使用方法。You can also use the Fail method in a switch statement.
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 。The default behavior is that the DefaultTraceListener outputs the message to a message box when the application is running in user interface mode and to the TraceListener instances in the Listeners collection.
备注
消息框的显示取决于是否存在 DefaultTraceListener 。The display of the message box is dependent on the presence of the DefaultTraceListener. 如果不 DefaultTraceListener 在 Listeners 集合中,则不显示消息框。If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListener可以通过 < > 清除、 < 删除 > 或调用 Clear Listeners 属性 () 来删除 System.Diagnostics.Trace.Listeners.Clear() 。The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).
可以通过将添加 TraceListener 到集合或从集合中删除一个来自定义此行为 Listeners 。You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.
另请参阅
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute
适用于
Fail(String, String)
发出错误消息及详细的错误消息。Emits an error message and a detailed error message.
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
static member Fail : string * string -> unit
Public Shared Sub Fail (message As String, detailMessage As String)
参数
- message
- String
要发出的消息。A message to emit.
- detailMessage
- String
要发出的详细消息。A detailed message to emit.
- 属性
示例
下面的示例使用 Fail 方法在异常处理过程中打印消息。The following example uses the Fail method to print a message during exception handling.
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
你还可以 Fail 在 switch 语句中使用方法。You can also use the Fail method in a switch statement.
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 。The default behavior is that the DefaultTraceListener outputs the message to a message box when the application is running in user interface mode and to the TraceListener instances in the Listeners collection.
备注
消息框的显示取决于是否存在 DefaultTraceListener 。The display of the message box is dependent on the presence of the DefaultTraceListener. 如果不 DefaultTraceListener 在 Listeners 集合中,则不显示消息框。If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListener可以通过 < > 清除、 < 删除 > 或调用 Clear Listeners 属性 () 来删除 System.Diagnostics.Trace.Listeners.Clear() 。The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).
可以通过将添加 TraceListener 到集合或从集合中删除一个来自定义此行为 Listeners 。You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.
另请参阅
- Debug
- Trace
- BooleanSwitch
- TraceSwitch
- TraceListener
- DefaultTraceListener
- ConsoleTraceListener
- ConditionalAttribute