Trace.Fail Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.TraceSource.dll

Emite un mensaje de error.

Sobrecargas

Fail(String)	Emite el mensaje de error especificado.
Fail(String, String)	Emite un mensaje de error y un mensaje de error detallado.

Fail(String)

Source:

Trace.cs

Emite el mensaje de error especificado.

public:
 static void Fail(System::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)

Parámetros

message

String

Mensaje que se va a emitir.

Atributos

ConditionalAttribute

Ejemplos

En el ejemplo siguiente se usa el método para imprimir un mensaje durante el Fail control de excepciones.

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

También puede usar el Fail método en una instrucción switch.

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

Comentarios

El comportamiento predeterminado del agente de escucha de seguimiento predeterminado es generar el message parámetro en un cuadro de mensaje cuando la aplicación se ejecuta en modo de interfaz de usuario y en las TraceListener instancias de la Listeners colección.

Nota

La presentación del cuadro de mensaje depende de la presencia de DefaultTraceListener. Si no DefaultTraceListener está en la Listeners colección, no se muestra el cuadro de mensaje. Puede DefaultTraceListener quitarse mediante la <desactivación>, la <eliminación> o llamando al Clear método en la Listeners propiedad (System.Diagnostics.Trace.Listeners.Clear()).

Puede personalizar este comportamiento agregando a TraceListener o quitando uno de la Listeners colección.

Consulte también

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Fail(String, String)

Source:

Trace.cs

Emite un mensaje de error y un mensaje de error detallado.

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")>]
static member Fail : string * string -> unit

Public Shared Sub Fail (message As String, detailMessage As String)

Parámetros

message

String

Mensaje que se va a emitir.

detailMessage

String

Mensaje detallado que se va a emitir.

Atributos

ConditionalAttribute

Ejemplos

En el ejemplo siguiente se usa el método para imprimir un mensaje durante el Fail control de excepciones.

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

También puede usar el Fail método en una instrucción switch.

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

Comentarios

El comportamiento predeterminado es que el agente de escucha de seguimiento predeterminado produzca el message parámetro y el detailedMessage parámetro en un cuadro de mensaje cuando la aplicación se ejecute en modo de interfaz de usuario y en las TraceListener instancias de la Listeners colección.

Nota

La presentación del cuadro de mensaje depende de la presencia de DefaultTraceListener. Si no DefaultTraceListener está en la Listeners colección, no se muestra el cuadro de mensaje. Puede DefaultTraceListener quitarse mediante la <desactivación>, la <eliminación> o llamando al Clear método en la Listeners propiedad (System.Diagnostics.Trace.Listeners.Clear()).

Puede personalizar este comportamiento agregando a TraceListener o quitando uno de la Listeners colección.

Consulte también

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute