Debug.WriteIf Metod

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

public:
 static void WriteIf(bool condition, System::Diagnostics::Debug::WriteIfInterpolatedStringHandler % message);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf(bool condition, ref System.Diagnostics.Debug.WriteIfInterpolatedStringHandler message);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteIf : bool * WriteIfInterpolatedStringHandler -> unit

Public Shared Sub WriteIf (condition As Boolean, ByRef message As Debug.WriteIfInterpolatedStringHandler)

Parametrar

Attribut

ConditionalAttribute

Kommentarer

Den här överbelastningen introducerades i .NET 6 för att förbättra prestandan. I jämförelse med de överlagringar som tar en String parameter utvärderar den här överlagringen endast eventuella interpolerade strängformateringsobjekt om meddelandet krävs.

Som standard skrivs utdata till en instans av DefaultTraceListener.

Använd parametern category för att gruppera utdatameddelanden.

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

Se även

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

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

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

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

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf(bool condition, object? value);

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

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

Parametrar

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 matar exemplet ut förnamnet på värdeparametern 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 ett meddelande på samma rad som det första meddelandet. En radavgränsare följer det andra meddelandet.

// 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.
    Debug.WriteIf(generalSwitch.TraceError, myObject);

    // Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, " is not a valid value for this method.");
}

' 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.
    Debug.WriteIf(generalSwitch.TraceError, myObject)
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, " is not a valid value for this method.")
End Sub

Kommentarer

Som standard skrivs utdata till en instans av DefaultTraceListener.

Den här metoden anropar Write 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 WriteIf(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 falseanropar Write(String)du inte . Det andra exemplet anropar WriteIf(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)
    Debug.Write("aNumber = " + aNumber + " out of range");

Andra exemplet:

Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Se även

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

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

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

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

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf(bool condition, string? message);

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

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

Parametrar

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. En radavgränsare följer det andra meddelandet.

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

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

    // Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteIf(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.
    Debug.WriteIf(generalSwitch.TraceError, "My error message. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, "My second error message.")
End Sub

Kommentarer

Som standard skrivs utdata till en instans av DefaultTraceListener.

Den här metoden anropar Write 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 WriteIf(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 falseanropar Write(String)du inte . Det andra exemplet anropar WriteIf(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)
    Debug.Write("aNumber = " + aNumber + " out of range");

Andra exemplet:

Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Se även

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

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

public:
 static void WriteIf(bool condition, System::Diagnostics::Debug::WriteIfInterpolatedStringHandler % message, System::String ^ category);

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf(bool condition, ref System.Diagnostics.Debug.WriteIfInterpolatedStringHandler message, string? category);

[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteIf : bool * WriteIfInterpolatedStringHandler * string -> unit

Public Shared Sub WriteIf (condition As Boolean, ByRef message As Debug.WriteIfInterpolatedStringHandler, category As String)

Parametrar

Attribut

ConditionalAttribute

Kommentarer

Den här överbelastningen introducerades i .NET 6 för att förbättra prestandan. I jämförelse med de överlagringar som tar en String parameter utvärderar den här överlagringen endast eventuella interpolerade strängformateringsobjekt om meddelandet krävs.

Som standard skrivs utdata till en instans av DefaultTraceListener.

Använd parametern category för att gruppera utdatameddelanden.

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

Se även

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

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

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

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

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

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

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

Parametrar

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å TraceLevelVerbosematar exemplet ut namnet på myObject och category till Listeners. Information om hur du lägger till en lyssnare i Listeners samlingen finns i TraceListenerCollection klassen .

Om TraceLevel är inställt på Error eller högre returnerar exemplet sedan det andra felmeddelandet på samma rad som det första meddelandet. En radavgränsare följer det andra meddelandet.

// 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 Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, myObject, category);

    // Write a second message if the TraceSwitch level is set to Error or higher.
    Debug.WriteLineIf(generalSwitch.TraceError, " Object is not valid for this 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 Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, myObject, category)
    
    ' Write a second message if the TraceSwitch level is set to Error or higher.
    Debug.WriteLineIf(generalSwitch.TraceError, " Object is not valid for this 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 Write 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 WriteIf(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 falseanropar Write(String)du inte . Det andra exemplet anropar WriteIf(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)
    Debug.Write("aNumber = " + aNumber + " out of range");

Andra exemplet:

Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Se även

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

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

Källa:

Debug.cs

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

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

[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf(bool condition, string? message, string? category);

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

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

Parametrar

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å TraceLevelVerbosematar exemplet ut 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å Error eller högre returnerar exemplet sedan det andra felmeddelandet på samma rad som det första meddelandet. En radavgränsare följer det andra meddelandet.

// 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 Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, myObject.ToString() +
       " is not a valid object for category: ", category);

    // Write a second message if the TraceSwitch level is set to Error or higher.
    Debug.WriteLineIf(generalSwitch.TraceError, " Please use a different 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 Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, myObject.ToString() & _
        " is not a valid object for category: ", category)
    
    ' Write a second message if the TraceSwitch level is set to Error or higher.
    Debug.WriteLineIf(generalSwitch.TraceError, " Please use a different 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 TraceListener.Write 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 WriteIf(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 falseanropar Write(String)du inte . Det andra exemplet anropar WriteIf(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)
    Debug.Write("aNumber = " + aNumber + " out of range");

Andra exemplet:

Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

Se även

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