Trace.Fail Metodo

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

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)

Origine:

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")>]
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^ ) 
{
   #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 metodo in un'istruzione Fail 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 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

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Fail(String, String)

Origine:

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")>]
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^ ) 
{
  #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 metodo in un'istruzione Fail 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 è per il listener di traccia predefinito per restituire 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

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

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute