Condividi tramite


Debug.Fail Metodo

Definizione

Genera un messaggio di errore.

Overload

Fail(String, String)

Genera un messaggio di errore e un messaggio di errore dettagliato.

Fail(String)

Genera il messaggio di errore specificato.

Fail(String, String)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

Genera un messaggio di errore e un messaggio di errore dettagliato.

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)

Parametri

message
String

Messaggio da generare.

detailMessage
String

Messaggio dettagliato da generare.

Attributi

Esempio

Nell'esempio seguente viene usato il metodo per stampare un messaggio durante la Fail gestione delle eccezioni.

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

È anche possibile usare il metodo in un'istruzione Fail 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

Commenti

Il comportamento predefinito è che il DefaultTraceListener messaggio viene restituito a una finestra di messaggio quando l'applicazione è in esecuzione in modalità interfaccia utente e nelle TraceListener istanze della Listeners raccolta.

Nota

La visualizzazione della finestra di messaggio dipende dalla presenza di DefaultTraceListener. Se l'oggetto DefaultTraceListenerListeners non è presente nella raccolta, la finestra di messaggio non viene visualizzata. L'oggetto DefaultTraceListener può essere rimosso dalla <proprietà clear>, dalla <rimozione> o chiamando il Clear metodo sulla Listeners proprietà (System.Diagnostics.Trace.Listeners.Clear()).

È possibile personalizzare questo comportamento aggiungendo un TraceListener oggetto a o rimuovendone uno dalla Listeners raccolta.

Vedi anche

Si applica a

Fail(String)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

Genera il messaggio di errore specificato.

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)

Parametri

message
String

Messaggio da generare.

Attributi

Esempio

Nell'esempio seguente viene usato il metodo per stampare un messaggio durante la Fail gestione delle eccezioni.

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

È anche possibile usare il metodo in un'istruzione Fail 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

Commenti

Il comportamento predefinito è che il DefaultTraceListener messaggio viene restituito a una finestra di messaggio quando l'applicazione è in esecuzione in modalità interfaccia utente e nelle TraceListener istanze della Listeners raccolta.

Nota

La visualizzazione della finestra di messaggio dipende dalla presenza di DefaultTraceListener. Se l'oggetto DefaultTraceListenerListeners non è presente nella raccolta, la finestra di messaggio non viene visualizzata. L'oggetto DefaultTraceListener può essere rimosso dalla <proprietà clear>, dalla <rimozione> o chiamando il Clear metodo sulla Listeners proprietà (System.Diagnostics.Trace.Listeners.Clear()).

È possibile personalizzare questo comportamento aggiungendo un TraceListener oggetto a o rimuovendone uno dalla Listeners raccolta.

Vedi anche

Si applica a