Trace.Fail 方法
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
发出一条错误消息。
| Fail(String) |
发出指定的错误消息。 |
| Fail(String, String) |
发出一条错误消息和一条详细的错误消息。 |
- Source:
- Trace.cs
- Source:
- Trace.cs
- Source:
- Trace.cs
发出指定的错误消息。
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 -> unitPublic Shared Sub Fail (message As String)参数
- message
- String
要发出的消息。
- 属性
示例
以下示例使用 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>、remove 或调用 属性上的 方法 () 来删除< 。><System.Diagnostics.Trace.Listeners.Clear()ListenersClear
可以通过将 添加到 TraceListener 集合或通过从 Listeners 集合中删除一个来自定义此行为。
另请参阅
适用于
.NET 9 和其他版本
| 产品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Source:
- Trace.cs
- Source:
- Trace.cs
- Source:
- 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")]
public static void Fail (string message, string detailMessage);[<System.Diagnostics.Conditional("TRACE")>]
static member Fail : string * string -> unitPublic Shared Sub Fail (message As String, detailMessage As String)参数
- message
- String
要发出的消息。
- detailMessage
- String
要发出的详细消息。
- 属性
示例
以下示例使用 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集合中的ListenersdetailedMessage实例。
备注
消息框的显示取决于 是否存在 DefaultTraceListener。
DefaultTraceListener如果 不在集合中Listeners，则不显示消息框。
DefaultTraceListener可以通过 clear>、remove 或调用 属性上的 方法 () 来删除< 。><System.Diagnostics.Trace.Listeners.Clear()ListenersClear
可以通过将 添加到 TraceListener 集合或通过从 Listeners 集合中删除一个来自定义此行为。
另请参阅
适用于
.NET 9 和其他版本
| 产品 | 版本 |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
