Trace.Fail Metoda

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestawy:

netstandard.dll, System.Diagnostics.TraceSource.dll

Emituje komunikat o błędzie.

Przeciążenia

Nazwa	Opis
Fail(String)	Emituje określony komunikat o błędzie.
Fail(String, String)	Emituje komunikat o błędzie i szczegółowy komunikat o błędzie.

Fail(String)

Źródło:

Trace.cs

Emituje określony komunikat o błędzie.

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)

Parametry

message

String

Komunikat do emisji.

Atrybuty

ConditionalAttribute

Przykłady

W poniższym przykładzie użyto Fail metody , aby wydrukować komunikat podczas obsługi wyjątków.

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

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

Można również użyć Fail metody w instrukcji switch.

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

Uwagi

Domyślnym zachowaniem domyślnego odbiornika śledzenia jest wyprowadzenie parametru message do pola komunikatu, gdy aplikacja działa w trybie interfejsu użytkownika i TraceListener do wystąpień w Listeners kolekcji.

Uwaga / Notatka

Wyświetlanie pola komunikatu zależy od obecności elementu DefaultTraceListener. Jeśli element DefaultTraceListener nie znajduje się w Listeners kolekcji, okno komunikatu nie jest wyświetlane. Obiekt DefaultTraceListener można usunąć za pomocą <czyszczenia>, <usuwania> lub wywoływania Clear metody we Listeners właściwości (System.Diagnostics.Trace.Listeners.Clear()).

To zachowanie można dostosować, dodając element TraceListener do lub usuwając go z kolekcji Listeners .

Zobacz też

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

Fail(String, String)

Źródło:

Trace.cs

Emituje komunikat o błędzie i szczegółowy komunikat o błędzie.

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)

Parametry

message

String

Komunikat do emisji.

detailMessage

String

Szczegółowy komunikat do emisji.

Atrybuty

ConditionalAttribute

Przykłady

W poniższym przykładzie użyto Fail metody , aby wydrukować komunikat podczas obsługi wyjątków.

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

Można również użyć Fail metody w instrukcji switch.

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

Uwagi

Domyślne zachowanie dotyczy domyślnego odbiornika śledzenia w celu wyprowadzenia parametru message i detailedMessage parametru do pola komunikatu, gdy aplikacja działa w trybie interfejsu użytkownika i TraceListener do wystąpień w Listeners kolekcji.

Uwaga / Notatka

Wyświetlanie pola komunikatu zależy od obecności elementu DefaultTraceListener. Jeśli element DefaultTraceListener nie znajduje się w Listeners kolekcji, okno komunikatu nie jest wyświetlane. Obiekt DefaultTraceListener można usunąć za pomocą <czyszczenia>, <usuwania> lub wywoływania Clear metody we Listeners właściwości (System.Diagnostics.Trace.Listeners.Clear()).

To zachowanie można dostosować, dodając element TraceListener do lub usuwając go z kolekcji Listeners .

Zobacz też

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