Trace.WriteLineIf Metod

Definition

Namnområde:: System.Diagnostics

Sammansättning:: System.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Skriver information om spårningen till spårningslyssnare Listeners i samlingen om ett villkor är true.

Överlagringar

Name	Description
WriteLineIf(Boolean, Object, String)	Skriver ett kategorinamn och värdet för objektets metod till spårningslyssnare ToString() i Listeners samlingen om ett villkor är `true`.
WriteLineIf(Boolean, Object)	Skriver värdet för objektets -metod till spårningslyssnare ToString() i Listeners samlingen om ett villkor är `true`.
WriteLineIf(Boolean, String)	Skriver ett meddelande till spårningslyssnare Listeners i samlingen om ett villkor är `true`.
WriteLineIf(Boolean, String, String)	Skriver ett kategorinamn och ett meddelande till spårningslyssnare Listeners i samlingen om ett villkor är `true`.

WriteLineIf(Boolean, Object, String)

Skriver ett kategorinamn och värdet för objektets metod till spårningslyssnare ToString() i Listeners samlingen om ett villkor är true.

public:
 static void WriteLineIf(bool condition, System::Object ^ value, System::String ^ category);

[System.Diagnostics.Conditional("TRACE")]
public static void WriteLineIf(bool condition, object value, string category);

[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLineIf : bool * obj * string -> unit

Public Shared Sub WriteLineIf (condition As Boolean, value As Object, category As String)

Parametrar

condition: Boolean

trueför att göra så att ett meddelande skrivs. annars . false

value: Object

En Object vars namn skickas till Listeners.

category: String

Ett kategorinamn som används för att organisera utdata.

Attribut: ConditionalAttribute

Exempel

I följande exempel skapas ett TraceSwitch med namnet generalSwitch. Den här växeln anges utanför kodexemplet.

Om växeln är inställd på TraceLevelError eller högre utdata exemplet det första felmeddelandet till Listeners. Information om hur du lägger till en lyssnare i Listeners samlingen finns i TraceListenerCollection klassen .

Om TraceLevel är inställt på Verbosereturnerar exemplet sedan det andra felmeddelandet på samma rad som det första meddelandet. Det andra meddelandet följs av en radavslutare.

// Class-level declaration.
 // Create a TraceSwitch.
 static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

 static public void MyErrorMethod(Object myObject, string category) {
    // Write the message if the TraceSwitch level is set to Error or higher.
    Trace.WriteIf(generalSwitch.TraceError, "Invalid object for category. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, myObject, category);
 }

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")

Public Shared Sub MyErrorMethod(myObject As Object, category As String)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Trace.WriteIf(generalSwitch.TraceError, "Invalid object for category. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, myObject, category)
End Sub

Kommentarer

Som standard skrivs utdata till en instans av DefaultTraceListener.

Parametern category kan användas för att gruppera utdatameddelanden.

Den här metoden anropar WriteLine spårningslyssnarens metod.

Anteckningar till arvingar

Du kan minimera prestandastraffet för instrumentering av ditt program med hjälp If...Then av instruktioner i stället för att använda WriteLineIf(Boolean, String) instruktioner. Följande två kodexempel skickar samma felsökningsmeddelande. Det första exemplet är dock mycket snabbare när spårningen är av, för om mySwitch.TraceError utvärderas till false anropar WriteLine(String)du inte . Det andra exemplet anropar WriteLineIf(Boolean, String)alltid , även när mySwitch.TraceError är false och inga spårningsutdata skapas. Detta kan leda till onödig körning av godtyckligt komplex kod.

Första exemplet

if(mySwitch.TraceError)
    Trace.WriteLine("aNumber = " + aNumber + " out of range");

Andra exemplet

Trace.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Se även

Gäller för

WriteLineIf(Boolean, Object)

Skriver värdet för objektets -metod till spårningslyssnare ToString() i Listeners samlingen om ett villkor är true.

public:
 static void WriteLineIf(bool condition, System::Object ^ value);

[System.Diagnostics.Conditional("TRACE")]
public static void WriteLineIf(bool condition, object value);

[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLineIf : bool * obj -> unit

Public Shared Sub WriteLineIf (condition As Boolean, value As Object)

Parametrar

condition: Boolean

trueför att göra så att ett meddelande skrivs. annars . false

value: Object

En Object vars namn skickas till Listeners.

Attribut: ConditionalAttribute

Exempel

I följande exempel skapas ett TraceSwitch med namnet generalSwitch. Den här växeln anges utanför kodexemplet.

Om TraceLevel är inställt på Verbosereturnerar exemplet sedan namnet på objektet på samma rad som det första meddelandet. Det andra meddelandet följs av en radavslutare.

// Class-level declaration.
 // Create a TraceSwitch.
 static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

 static public void MyErrorMethod(Object myObject) {
    // Write the message if the TraceSwitch level is set to Error or higher.
    Trace.WriteIf(generalSwitch.TraceError, "Invalid object. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, myObject);
 }

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(myObject As Object)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Trace.WriteIf(generalSwitch.TraceError, "Invalid object. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, myObject)
End Sub

Kommentarer

Som standard skrivs utdata till en instans av DefaultTraceListener.

Den här metoden anropar WriteLine spårningslyssnarens metod.

Anteckningar till arvingar

Första exemplet

if(mySwitch.TraceError)
    Trace.WriteLine("aNumber = " + aNumber + " out of range");

Andra exemplet

Trace.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Se även

Gäller för

WriteLineIf(Boolean, String)

Skriver ett meddelande till spårningslyssnare Listeners i samlingen om ett villkor är true.

public:
 static void WriteLineIf(bool condition, System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public static void WriteLineIf(bool condition, string message);

[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLineIf : bool * string -> unit

Public Shared Sub WriteLineIf (condition As Boolean, message As String)

Parametrar

condition: Boolean

trueför att göra så att ett meddelande skrivs. annars . false

message: String

Ett meddelande att skriva.

Attribut: ConditionalAttribute

Exempel

I följande exempel skapas ett TraceSwitch med namnet generalSwitch. Den här växeln anges utanför kodexemplet.

Om TraceLevel är inställt på Verbosereturnerar exemplet sedan det andra felmeddelandet på samma rad som det första meddelandet. Det andra meddelandet följs av en radavslutare.

// Class-level declaration.
 // Create a TraceSwitch.
 static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

 static public void MyErrorMethod() {
    // Write the message if the TraceSwitch level is set to Error or higher.
    Trace.WriteIf(generalSwitch.TraceError, "My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, "My second error message.");
 }

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")

Public Shared Sub MyErrorMethod()
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Trace.WriteIf(generalSwitch.TraceError, "My error message. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, "My second error message.")
End Sub

Kommentarer

Som standard skrivs utdata till en instans av DefaultTraceListener.

Den här metoden anropar WriteLine spårningslyssnarens metod.

Anteckningar till arvingar

Första exemplet

if(mySwitch.TraceError)
    Trace.WriteLine("aNumber = " + aNumber + " out of range");

Andra exemplet

Trace.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Se även

Gäller för

WriteLineIf(Boolean, String, String)

Skriver ett kategorinamn och ett meddelande till spårningslyssnare Listeners i samlingen om ett villkor är true.

public:
 static void WriteLineIf(bool condition, System::String ^ message, System::String ^ category);

[System.Diagnostics.Conditional("TRACE")]
public static void WriteLineIf(bool condition, string message, string category);

[<System.Diagnostics.Conditional("TRACE")>]
static member WriteLineIf : bool * string * string -> unit

Public Shared Sub WriteLineIf (condition As Boolean, message As String, category As String)

Parametrar

condition: Boolean

trueför att göra så att ett meddelande skrivs. annars . false

message: String

Ett meddelande att skriva.

category: String

Ett kategorinamn som används för att organisera utdata.

Attribut: ConditionalAttribute

Exempel

I följande exempel skapas ett TraceSwitch med namnet generalSwitch. Den här växeln anges utanför kodexemplet.

Om TraceLevel är inställt på Verbosereturnerar exemplet sedan det andra felmeddelandet och category på samma rad som det första meddelandet. Det andra meddelandet följs av en radavslutare.

// Class-level declaration.
 // Create a TraceSwitch.
 static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

 static public void MyErrorMethod(string category) {
    // Write the message if the TraceSwitch level is set to Error or higher.
    Trace.WriteIf(generalSwitch.TraceError, "My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, "My second error message.", category);
 }

' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")

Public Shared Sub MyErrorMethod(category As String)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Trace.WriteIf(generalSwitch.TraceError, "My error message. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Trace.WriteLineIf(generalSwitch.TraceVerbose, _
        "My second error message.", category)
End Sub

Kommentarer

Som standard skrivs utdata till en instans av DefaultTraceListener.

Parametern category kan användas för att gruppera utdatameddelanden.

Den här metoden anropar WriteLine spårningslyssnarens metod.

Anteckningar till arvingar

Första exemplet

if(mySwitch.TraceError)
    Trace.WriteLine("aNumber = " + aNumber + " out of range");

Andra exemplet

Trace.WriteLineIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Se även

Gäller för

Feedback

Var den här sidan till hjälp?