Debug.Fail Método

Definición

Emite un mensaje de error.Emits an error message.

Sobrecargas

Fail(String)

Emite el mensaje de error especificado.Emits the specified error message.

Fail(String, String)

Emite un mensaje de error y un mensaje de error detallado.Emits an error message and a detailed error message.

Fail(String)

Emite el mensaje de error especificado.Emits the specified error message.

public:
 static void Fail(System::String ^ message);
[System.Diagnostics.Conditional("DEBUG")]
public static void Fail (string message);
static member Fail : string -> unit
Public Shared Sub Fail (message As String)

Parámetros

message
String

Mensaje que se va a emitir.A message to emit.

Atributos

Ejemplos

En el ejemplo siguiente se Fail usa el método para imprimir un mensaje durante el control de excepciones.The following example uses the Fail method to print a message during exception handling.

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 utilizar el Fail método en una instrucción 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(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 el DefaultTraceListener genera el mensaje en un cuadro de mensaje cuando la aplicación se ejecuta en modo de interfaz de usuario TraceListener y en las Listeners instancias de la colección.The default behavior is that the DefaultTraceListener outputs the message to a message box when the application is running in user interface mode and to the TraceListener instances in the Listeners collection.

Nota

La presentación del cuadro de mensaje depende de la presencia de DefaultTraceListener.The display of the message box is dependent on the presence of the DefaultTraceListener. Listeners Si no DefaultTraceListener está en la colección, no se muestra el cuadro de mensaje.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. <> Listeners System.Diagnostics.Trace.Listeners.Clear() <> Clear El puede quitarse mediante el borrado, la eliminación o llamando al método en la propiedad (). DefaultTraceListenerThe DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Puede personalizar este comportamiento agregando TraceListener o quitando una de la Listeners colección.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Consulte también:

Fail(String, String)

Emite un mensaje de error y un mensaje de error detallado.Emits an error message and a detailed error message.

public:
 static void Fail(System::String ^ message, System::String ^ detailMessage);
[System.Diagnostics.Conditional("DEBUG")]
public static void Fail (string message, string detailMessage);
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.A message to emit.

detailMessage
String

Mensaje detallado que se va a emitir.A detailed message to emit.

Atributos

Ejemplos

En el ejemplo siguiente se Fail usa el método para imprimir un mensaje durante el control de excepciones.The following example uses the Fail method to print a message during exception handling.

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 utilizar el Fail método en una instrucción 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(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 el DefaultTraceListener genera el mensaje en un cuadro de mensaje cuando la aplicación se ejecuta en modo de interfaz de usuario TraceListener y en las Listeners instancias de la colección.The default behavior is that the DefaultTraceListener outputs the message to a message box when the application is running in user interface mode and to the TraceListener instances in the Listeners collection.

Nota

La presentación del cuadro de mensaje depende de la presencia de DefaultTraceListener.The display of the message box is dependent on the presence of the DefaultTraceListener. Listeners Si no DefaultTraceListener está en la colección, no se muestra el cuadro de mensaje.If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. <> Listeners System.Diagnostics.Trace.Listeners.Clear() <> Clear El puede quitarse mediante el borrado, la eliminación o llamando al método en la propiedad (). DefaultTraceListenerThe DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

Puede personalizar este comportamiento agregando TraceListener o quitando una de la Listeners colección.You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

Consulte también:

Se aplica a