Trace.Fail Methode

Definitie

Naamruimte:
System.Diagnostics
Assembly:
System.dll
Assembly:
netstandard.dll

Er wordt een foutbericht verzonden.

Overloads

Name Description
Fail(String)

Hiermee wordt het opgegeven foutbericht verzonden.
Fail(String, String)

Verzendt een foutbericht en een gedetailleerd foutbericht.

Fail(String)

Hiermee wordt het opgegeven foutbericht verzonden.

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)

Parameters

message
String

Een bericht dat moet worden verzonden.

Kenmerken
ConditionalAttribute

Voorbeelden

In het volgende voorbeeld wordt de methode gebruikt om een bericht af te drukken tijdens het Fail verwerken van uitzonderingen.

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

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

U kunt de Fail methode ook gebruiken in een switch-instructie.

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

Opmerkingen

Het standaardgedrag voor de standaardtraceringslistener is het uitvoeren van de message parameter naar een berichtvak wanneer de toepassing wordt uitgevoerd in de gebruikersinterfacemodus en naar de TraceListener exemplaren in de Listeners verzameling.

Note

De weergave van het berichtvak is afhankelijk van de aanwezigheid van de DefaultTraceListener. Als de DefaultTraceListener verzameling zich niet in de Listeners verzameling bevindt, wordt het berichtvak niet weergegeven. De DefaultTraceListener kan worden verwijderd door het <wissen>, verwijderen<> of door de Clear methode op de eigenschap (System.Diagnostics.Trace.Listeners.Clear()) aan te Listeners roepen.

U kunt dit gedrag aanpassen door een TraceListener aan de verzameling toe te voegen of door er een uit te Listeners verwijderen.

Zie ook

Van toepassing op

Fail(String, String)

Verzendt een foutbericht en een gedetailleerd foutbericht.

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)

Parameters

message
String

Een bericht dat moet worden verzonden.

detailMessage
String

Een gedetailleerd bericht dat moet worden verzonden.

Kenmerken
ConditionalAttribute

Voorbeelden

In het volgende voorbeeld wordt de methode gebruikt om een bericht af te drukken tijdens het Fail verwerken van uitzonderingen.

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

U kunt de Fail methode ook gebruiken in een switch-instructie.

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

Opmerkingen

Het standaardgedrag is voor de standaardtraceerlistener om de message parameter en de detailedMessage parameter uit te voeren naar een berichtvak wanneer de toepassing wordt uitgevoerd in de gebruikersinterfacemodus en naar de TraceListener exemplaren in de Listeners verzameling.

Note

De weergave van het berichtvak is afhankelijk van de aanwezigheid van de DefaultTraceListener. Als de DefaultTraceListener verzameling zich niet in de Listeners verzameling bevindt, wordt het berichtvak niet weergegeven. De DefaultTraceListener kan worden verwijderd door het <wissen>, verwijderen<> of door de Clear methode op de eigenschap (System.Diagnostics.Trace.Listeners.Clear()) aan te Listeners roepen.

U kunt dit gedrag aanpassen door een TraceListener aan de verzameling toe te voegen of door er een uit te Listeners verwijderen.

Zie ook

Van toepassing op