Trace.Fail Metoda

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.TraceSource.dll

Vygeneruje chybovou zprávu.

Přetížení

Name	Description
Fail(String)	Vygeneruje zadanou chybovou zprávu.
Fail(String, String)	Vygeneruje chybovou zprávu a podrobnou chybovou zprávu.

Fail(String)

Zdroj:

Trace.cs

Vygeneruje zadanou chybovou zprávu.

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

Zpráva, která se má vygenerovat.

Atributy

ConditionalAttribute

Příklady

Následující příklad používá metodu Fail k tisku zprávy během zpracování výjimek.

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

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

Metodu Fail můžete použít také v příkazu 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

Poznámky

Výchozí chování výchozího naslouchacího procesu trasování je výstupem message parametru do pole se zprávou, když aplikace běží v režimu uživatelského rozhraní a do TraceListener instancí v kolekci Listeners .

Poznámka:

Zobrazení pole zprávy závisí na přítomnosti DefaultTraceListener. Pokud v kolekci DefaultTraceListener není Listeners , pole se zprávou se nezobrazí. Lze DefaultTraceListener odebrat <vymazáním>, <odebráním> nebo voláním Clear metody ve Listeners vlastnosti (System.Diagnostics.Trace.Listeners.Clear()).

Toto chování můžete přizpůsobit tak, že do kolekce přidáte TraceListener nebo ji Listeners odeberete.

Viz také

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

Fail(String, String)

Zdroj:

Trace.cs

Vygeneruje chybovou zprávu a podrobnou chybovou zprávu.

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

Zpráva, která se má vygenerovat.

detailMessage

String

Podrobná zpráva, která se má vygenerovat.

Atributy

ConditionalAttribute

Příklady

Následující příklad používá metodu Fail k tisku zprávy během zpracování výjimek.

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

Metodu Fail můžete použít také v příkazu 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

Poznámky

Výchozí chování je pro výchozí naslouchací proces message trasování výstup parametr a detailedMessage parametr do pole zprávy, když aplikace běží v režimu uživatelského rozhraní a TraceListener instance v kolekci Listeners .

Poznámka:

Zobrazení pole zprávy závisí na přítomnosti DefaultTraceListener. Pokud v kolekci DefaultTraceListener není Listeners , pole se zprávou se nezobrazí. Lze DefaultTraceListener odebrat <vymazáním>, <odebráním> nebo voláním Clear metody ve Listeners vlastnosti (System.Diagnostics.Trace.Listeners.Clear()).

Toto chování můžete přizpůsobit tak, že do kolekce přidáte TraceListener nebo ji Listeners odeberete.

Viz také

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