Trace.Fail Metod

Definition

Namnområde:
System.Diagnostics
Sammansättningar:
netstandard.dll, System.Diagnostics.TraceSource.dll
Sammansättning:
System.Diagnostics.TraceSource.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Genererar ett felmeddelande.

Överlagringar

Name Description
Fail(String)

Genererar det angivna felmeddelandet.
Fail(String, String)

Genererar ett felmeddelande och ett detaljerat felmeddelande.

Fail(String)

Källa:
Trace.cs
Källa:
Trace.cs
Källa:
Trace.cs
Källa:
Trace.cs
Källa:
Trace.cs

Genererar det angivna felmeddelandet.

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)

Parametrar

message
String

Ett meddelande som ska skickas.

Attribut
ConditionalAttribute

Exempel

I följande exempel används Fail metoden för att skriva ut ett meddelande vid undantagshantering.

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

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

Du kan också använda Fail metoden i en switch-instruktion.

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

Kommentarer

Standardbeteendet för standardspårningslyssnaren är att mata ut parametern message till en meddelanderuta när programmet körs i användargränssnittsläge och till TraceListener instanserna i Listeners samlingen.

Note

Visningen av meddelanderutan är beroende av förekomsten av DefaultTraceListener. Om inte DefaultTraceListener finns i Listeners samlingen visas inte meddelanderutan. DefaultTraceListener Kan tas bort av clear<>, remove<> eller genom att anropa Clear metoden på Listeners egenskapen (System.Diagnostics.Trace.Listeners.Clear()).

Du kan anpassa det här beteendet genom att lägga till en TraceListener i eller genom att ta bort en från Listeners samlingen.

Se även

Gäller för

Fail(String, String)

Källa:
Trace.cs
Källa:
Trace.cs
Källa:
Trace.cs
Källa:
Trace.cs
Källa:
Trace.cs

Genererar ett felmeddelande och ett detaljerat felmeddelande.

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)

Parametrar

message
String

Ett meddelande som ska skickas.

detailMessage
String

Ett detaljerat meddelande att avge.

Attribut
ConditionalAttribute

Exempel

I följande exempel används Fail metoden för att skriva ut ett meddelande vid undantagshantering.

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

Du kan också använda Fail metoden i en switch-instruktion.

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

Kommentarer

Standardbeteendet är att standardspårningslyssnaren matar ut message parametern och parametern detailedMessage till en meddelanderuta när programmet körs i användargränssnittsläge och till TraceListener instanserna i Listeners samlingen.

Note

Visningen av meddelanderutan är beroende av förekomsten av DefaultTraceListener. Om inte DefaultTraceListener finns i Listeners samlingen visas inte meddelanderutan. DefaultTraceListener Kan tas bort av clear<>, remove<> eller genom att anropa Clear metoden på Listeners egenskapen (System.Diagnostics.Trace.Listeners.Clear()).

Du kan anpassa det här beteendet genom att lägga till en TraceListener i eller genom att ta bort en från Listeners samlingen.

Se även

Gäller för