Debug.Fail Método

Referencia

Definición

Espacio de nombres:: System.Diagnostics

Ensamblado:: System.Diagnostics.Debug.dll

Ensamblado:: System.Runtime.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Source:: Debug.cs

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")]
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

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Fail(String)

Source:: Debug.cs

Source:: Debug.cs

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")]
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

Nota

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

Consulte también

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Colaborar con nosotros en GitHub

El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.

Comentarios de .NET

.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios:

Abrir incidencia con la documentación Proporcionar comentarios sobre el producto

Conéctese, escriba código y crezca

Compartir a través de

Definición

Sobrecargas

Fail(String, String)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Fail(String)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a