Trace.Fail Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt eine Fehlermeldung aus.
Überlädt
Fail(String) |
Gibt die angegebene Fehlermeldung aus. |
Fail(String, String) |
Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung aus. |
Fail(String)
Gibt die angegebene Fehlermeldung aus.
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)
Parameter
- message
- String
Eine auszugebende Meldung.
- Attribute
Beispiele
Im folgenden Beispiel wird die Methode zum Drucken einer Nachricht während der Fail Ausnahmebehandlung verwendet.
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
Sie können die Fail Methode auch in einer Switch-Anweisung verwenden.
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
Hinweise
Das Standardverhalten für den Standardablaufverfolgungslistener besteht darin, den message
Parameter in ein Meldungsfeld auszugeben, wenn die Anwendung im Benutzeroberflächenmodus und in die TraceListener Instanzen in der Listeners Auflistung ausgeführt wird.
Hinweis
Die Anzeige des Meldungsfelds hängt von der Anwesenheit des DefaultTraceListenerNachrichtenfelds ab. Wenn sich die DefaultTraceListener Listeners Auflistung nicht befindet, wird das Meldungsfeld nicht angezeigt. Dies DefaultTraceListener kann durch das <Löschen>>, entfernen< oder durch Aufrufen der Clear Methode für die Listeners Eigenschaft (System.Diagnostics.Trace.Listeners.Clear()
) entfernt werden.
Sie können dieses Verhalten anpassen, indem Sie eine zu, oder indem Sie eine TraceListener aus der Listeners Auflistung entfernen.
Siehe auch
Gilt für
Fail(String, String)
Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung aus.
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)
Parameter
- message
- String
Eine auszugebende Meldung.
- detailMessage
- String
Eine detaillierte Meldung, die ausgegeben werden soll.
- Attribute
Beispiele
Im folgenden Beispiel wird die Methode zum Drucken einer Nachricht während der Fail Ausnahmebehandlung verwendet.
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
Sie können die Fail Methode auch in einer Switch-Anweisung verwenden.
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
Hinweise
Das Standardverhalten richtet sich an den Standardablaufverfolgungslistener, um den message
Parameter und den detailedMessage
Parameter in ein Meldungsfeld auszugeben, wenn die Anwendung im Benutzeroberflächenmodus und in den TraceListener Instanzen in der Listeners Auflistung ausgeführt wird.
Hinweis
Die Anzeige des Meldungsfelds hängt von der Anwesenheit des DefaultTraceListenerNachrichtenfelds ab. Wenn sich die DefaultTraceListener Listeners Auflistung nicht befindet, wird das Meldungsfeld nicht angezeigt. Dies DefaultTraceListener kann durch das <Löschen>>, entfernen< oder durch Aufrufen der Clear Methode für die Listeners Eigenschaft (System.Diagnostics.Trace.Listeners.Clear()
) entfernt werden.
Sie können dieses Verhalten anpassen, indem Sie eine zu, oder indem Sie eine TraceListener aus der Listeners Auflistung entfernen.