通过

Trace.Fail 方法

定义

命名空间:
System.Diagnostics
程序集:
netstandard.dll, System.Diagnostics.TraceSource.dll
程序集:
System.Diagnostics.TraceSource.dll
程序集:
System.dll
程序集:
netstandard.dll

发出错误消息。

重载

名称 说明
Fail(String)

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

发出错误消息和详细的错误消息。

Fail(String)

Source:
Trace.cs
Source:
Trace.cs
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 -> unit
Public Shared Sub Fail (message As String)

参数

message
String

要发出的消息。

属性
ConditionalAttribute

示例

以下示例使用此方法 Fail 在异常处理期间打印消息。

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:
        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可以通过清除>、删除或调用属性（）上的方法来删除<该属性。><ListenersSystem.Diagnostics.Trace.Listeners.Clear()Clear

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

另请参阅

适用于

Fail(String, String)

Source:
Trace.cs
Source:
Trace.cs
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 -> unit
Public Shared Sub Fail (message As String, detailMessage As String)

参数

message
String

要发出的消息。

detailMessage
String

要发出的详细消息。

属性
ConditionalAttribute

示例

以下示例使用此方法 Fail 在异常处理期间打印消息。

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:
        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

注解

默认行为是默认跟踪侦听器在应用程序以用户界面模式运行时将参数和detailedMessage参数输出message到TraceListener消息框，以及集合中的Listeners实例。

注释

消息框的显示取决于是否存在 DefaultTraceListener。 DefaultTraceListener如果集合中Listeners不存在，则不显示消息框。 DefaultTraceListener可以通过清除>、删除或调用属性（）上的方法来删除<该属性。><ListenersSystem.Diagnostics.Trace.Listeners.Clear()Clear

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

另请参阅

适用于