Debug.Fail Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Diagnostics

Assembly:: System.Diagnostics.Debug.dll

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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)

Origine:: Debug.cs

Origine:: Debug.cs

Origine:: 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: ConditionalAttribute

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 DefaultTraceListener Listeners 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

.NET 9 e altre versioni

Prodotto	Versioni
.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)

Origine:: Debug.cs

Origine:: Debug.cs

Origine:: 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: ConditionalAttribute

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

Nota

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

Vedi anche

Si applica a

.NET 9 e altre versioni

Prodotto	Versioni
.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

Condividi tramite

Debug.Fail Metodo

Definizione

Overload

Fail(String, String)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

Fail(String)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive