Trace.Fail Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Diagnostics

Assembly:: System.Diagnostics.TraceSource.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)	Genera il messaggio di errore specificato.
Fail(String, String)	Genera un messaggio di errore e un messaggio di errore dettagliato.

Fail(String)

Source:: Trace.cs

Source:: Trace.cs

Source:: Trace.cs

Genera il messaggio di errore specificato.

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

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

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

[<System.Diagnostics.Conditional("TRACE")>]
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 utilizzato il metodo per stampare un messaggio durante la Fail gestione delle eccezioni.

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

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

Catch
    Trace.Fail("Unknown Option " + option1 + ", using the default.")
End Try

È anche possibile usare il Fail metodo in un'istruzione switch.

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

   // Insert additional cases.

   default:
      #if defined(TRACE)
      Trace::Fail(String::Format("Unknown Option {0}", option));
      #endif
      result = 1.0;
      break;
}

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

    // Insert additional cases.
    default:
        Trace.Fail("Unknown Option " + option);
        result = 1.0;
        break;
}

Select Case option1
    Case OptionConsts.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Trace.Fail(("Unknown Option " & option1))
        result = 1.0
End Select

Commenti

Il comportamento predefinito per il listener di traccia predefinito consiste nell'output del message parametro in una finestra di messaggio quando l'applicazione viene eseguita in modalità interfaccia utente e nelle TraceListener istanze della Listeners raccolta.

Nota

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

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

Vedi anche

Si applica a

Fail(String, String)

Source:: Trace.cs

Source:: Trace.cs

Source:: Trace.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("TRACE")]
public static void Fail (string? message, string? detailMessage);

[System.Diagnostics.Conditional("TRACE")]
public static void Fail (string message, string detailMessage);

[<System.Diagnostics.Conditional("TRACE")>]
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 utilizzato il metodo per stampare un messaggio durante la Fail gestione delle eccezioni.

catch ( Exception^ ) 
{
  #if defined(TRACE)
  Trace::Fail( String::Format( "Invalid value: {0}", value ),
      "Resetting value to newValue." );
   #endif
   value = newValue;
}

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

Catch
    Trace.Fail("Invalid value: " & value.ToString(), _
        "Resetting value to newValue.")
    value = newValue
End Try

È anche possibile usare il Fail metodo in un'istruzione switch.

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

   // Insert additional cases.

   default:
      #if defined(TRACE)
      Trace::Fail( String::Format( "Unsupported option {0}", option ),
         "Result set to 1.0" );
      #endif
      result = 1.0;
      break;
}

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

    // Insert additional cases.

    default:
        Trace.Fail("Unsupported option " + option, "Result set to 1.0");
        result = 1.0;
        break;
}

Select Case option1
    Case OptionConsts.First
        result = 1.0
    
    ' Insert additional cases.
    Case Else
        Trace.Fail("Unsupported option " & option1, "Result set to 1.0")
        result = 1.0
End Select

Commenti

Il comportamento predefinito è che il listener di traccia predefinito restituisca il message parametro e il detailedMessage parametro in una finestra di messaggio quando l'applicazione viene eseguita in modalità interfaccia utente e nelle TraceListener istanze della Listeners raccolta.

Nota

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

Vedi anche

Si applica a

Trace.Fail Metodo

Definizione

Overload

Fail(String)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

Fail(String, String)

Parametri

Esempio

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti

Risorse aggiuntive