Trace.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);
public static void Fail (string message);
[System.Diagnostics.Conditional("TRACE")]
public static void Fail (string message);
static member Fail : string -> unit
[<System.Diagnostics.Conditional("TRACE")>]
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^ ) 
{
   #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

你还可以 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(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 集合中的实例 ListenersThe default behavior for the default trace listener is to output the message parameter to a message box when the application runs in user-interface mode, and to the TraceListener instances in the Listeners collection.

备注

消息框的显示取决于是否存在 DefaultTraceListenerThe display of the message box is dependent on the presence of the DefaultTraceListener. 如果不 DefaultTraceListenerListeners 集合中,则不显示消息框。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 到集合或从集合中删除一个来自定义此行为 ListenersYou can customize this behavior by adding a TraceListener to, or by removing one from, the Listeners collection.

另请参阅

适用于

Fail(String, String)

发出一条错误消息和一条详细的错误消息。Emits an error message, and a detailed error message.

public:
 static void Fail(System::String ^ message, System::String ^ detailMessage);
public static void Fail (string message, string detailMessage);
[System.Diagnostics.Conditional("TRACE")]
public static void Fail (string message, string detailMessage);
static member Fail : string * string -> unit
[<System.Diagnostics.Conditional("TRACE")>]
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^ ) 
{
  #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

你还可以 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(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 detailedMessage 应用程序在用户界面模式下运行时,默认跟踪侦听器将参数和参数输出到消息框中,并将参数输出到 TraceListener 集合中的实例 ListenersThe default behavior is for the default trace listener to output the message parameter and the detailedMessage parameter to a message box when the application runs in user-interface mode, and to the TraceListener instances in the Listeners collection.

备注

消息框的显示取决于是否存在 DefaultTraceListenerThe display of the message box is dependent on the presence of the DefaultTraceListener. 如果不 DefaultTraceListenerListeners 集合中,则不显示消息框。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 到集合或从集合中删除一个来自定义此行为 ListenersYou can customize this behavior by adding a TraceListener to, or by removing one from, the Listeners collection.

另请参阅

适用于