Debug.Fail Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Runtime.dll

Emite un mensaje de error.

Sobrecargas

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

Fail(String, String)

Source:

Debug.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("DEBUG")]
public static void Fail (string? message, string? detailMessage);

[<System.Diagnostics.Conditional("DEBUG")>]
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 Fail método para imprimir un mensaje durante el control de excepciones.

catch ( Exception^ e ) 
{
   #if defined(DEBUG)
   Debug::Fail( "Cannot find SpecialController, proceeding with StandardController", "Setting Controller to default value" );
   #endif
}

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

Catch e As Exception
    Debug.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(DEBUG)
         Debug::Fail( "Unknown Option" + option, "Result set to 1.0" );
         #endif
         result = 1.0;
         break;
   }

switch (option1)
{
    case MyOption.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Debug.Fail("Unknown Option " + option1, "Result set to 1.0");
        result = 1.0;
        break;
}

Select Case option1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail("Unknown Option " & option1, "Result set to 1.0")
        result = 1.0
End Select

Comentarios

El comportamiento predeterminado es que genera DefaultTraceListener el mensaje 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. DefaultTraceListener Se puede quitar mediante la<> eliminación, la <eliminación> o llamando al Clear método en la Listeners propiedad (System.Diagnostics.Trace.Listeners.Clear()).

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

Consulte también

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

Fail(String)

Source:

Debug.cs

Emite el mensaje de error especificado.

public:
 static void Fail(System::String ^ message);

[System.Diagnostics.Conditional("DEBUG")]
public static void Fail (string? message);

[<System.Diagnostics.Conditional("DEBUG")>]
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 Fail método para imprimir un mensaje durante el control de excepciones.

catch ( Exception^ e ) 
{
   #if defined(DEBUG)
   Debug::Fail( "Unknown Option " + option + ", using the default." );
   #endif
}

catch (Exception)
{
    Debug.Fail("Unknown Option " + option + ", using the default.");
}

Catch e As Exception
    Debug.Fail("Unknown Option " + myOption1 + ", 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(DEBUG)
         Debug::Fail( "Unknown Option" + option );
         #endif
         result = 1.0;
         break;
   }

switch (option)
{
    case Option.First:
        result = 1.0;
        break;

    // Insert additional cases.

    default:
        Debug.Fail("Unknown Option " + option);
        result = 1.0;
        break;
}

Select Case myOption1
    Case MyOption.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Debug.Fail(("Unknown Option " & myOption1.ToString))
        result = 1.0
End Select

Comentarios

El comportamiento predeterminado es que genera DefaultTraceListener el mensaje 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. DefaultTraceListener Se puede quitar mediante la<> eliminación, la <eliminación> o llamando al Clear método en la Listeners propiedad (System.Diagnostics.Trace.Listeners.Clear()).

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

Consulte también

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