Esta documentación está archivada y no tiene mantenimiento.

Trace.Fail (Método) (String, String)

Actualización: noviembre 2007

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

Espacio de nombres:  System.Diagnostics
Ensamblado:  System (en System.dll)

[ConditionalAttribute("TRACE")]
public static void Fail(
	string message,
	string detailMessage
)
/** @attribute ConditionalAttribute("TRACE") */
public static void Fail(
	String message,
	String detailMessage
)
public static function Fail(
	message : String, 
	detailMessage : String
)

Parámetros

message
Tipo: System.String
Mensaje que se va a emitir.
detailMessage
Tipo: System.String
Mensaje detallado que se va a emitir.

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

zhswt5hc.alert_note(es-es,VS.90).gifNota:

La presentación del cuadro de mensaje depende de la presencia del DefaultTraceListener. Si DefaultTraceListener no está en la colección de Listeners, no se muestra el cuadro de mensaje. DefaultTraceListener se puede eliminar mediante Elemento <clear> de <listeners> de <trace> y Elemento <remove> de <listeners> de <trace>, o llamando al método Clear de la propiedad Listeners (System.Diagnostics.Trace.Listeners.Clear()).

Para personalizar este comportamiento, agregue un objeto TraceListener a la colección Listeners o quite uno de esta colección.

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

catch (Exception) {
    Trace.Fail("Invalid value: " + value.ToString(), 
       "Resetting value to newValue.");
    value = newValue;
}


catch (System.Exception exp) {
    Trace.Fail("Invalid value: " + System.Convert.ToString(value),
        "Resetting value to newValue.");
    value = newValue;
}


catch(e : Exception)
{
    @if(@TRACE)
    Trace.Fail("Invalid value: " + value.ToString(), 
       "Resetting value to newValue.")
    @end
    value = newValue
}


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

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;
}


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;
}


switch(option)
{
    case 1:
        result = 1.0
        break

  // Insert additional cases.

    default:
        @if(@TRACE)
        Trace.Fail("Unknown option: " + option, "result set to 1.0")
        @end
        result = 1.0
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5

XNA Framework

Compatible con: 2.0, 1.0
Mostrar: