Debug.WriteLineIf Metoda

Definice

Obor názvů:: System.Diagnostics

Sestavení:: System.dll, System.Diagnostics.Debug.dll

Sestavení:: netstandard.dll, System.Runtime.dll

Sestavení:: System.Diagnostics.Debug.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zapíše informace o ladění do naslouchacích procesů trasování v Listeners kolekci, pokud je truepodmínka .

Přetížení

Name	Description
WriteLineIf(Boolean, Object, String)	Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacích procesů trasování v Listeners kolekci, pokud je `true`podmínka .
WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler)	Zapíše zprávu do naslouchacích procesů trasování v Listeners kolekci, pokud je `true`zadaná podmínka .
WriteLineIf(Boolean, Object)	Zapíše hodnotu metody objektu ToString() do naslouchacích procesů trasování v Listeners kolekci, pokud je `true`podmínka .
WriteLineIf(Boolean, String)	Zapíše zprávu do naslouchacích procesů trasování v Listeners kolekci, pokud je `true`podmínka .
WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler, String)	Zapíše název kategorie a zprávu do naslouchacích procesů trasování v Listeners kolekci, pokud je `true`zadaná podmínka .
WriteLineIf(Boolean, String, String)	Zapíše název kategorie a zprávu do naslouchacích procesů trasování v Listeners kolekci, pokud je `true`podmínka .

WriteLineIf(Boolean, Object, String)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacích procesů trasování v Listeners kolekci, pokud je truepodmínka .

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

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

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

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

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

Parametry

condition: Boolean

Podmíněný výraz, který se má vyhodnotit. Pokud je truepodmínka , název a hodnota kategorie se zapisují do naslouchacích procesů trasování v kolekci.

value: Object

Objekt, jehož název je odeslán do objektu Listeners.

category: String

Název kategorie sloužící k uspořádání výstupu.

Atributy: ConditionalAttribute

Příklady

Následující příklad vytvoří pojmenovaný TraceSwitchgeneralSwitch. Tento přepínač je nastavený mimo vzorový kód.

Pokud je přepínač nastaven na TraceLevelError nebo vyšší, příklad zobrazí první chybovou Listenerszprávu do . Informace o přidání naslouchacího Listeners procesu do kolekce najdete v TraceListenerCollection třídě.

Pokud je nastavena na TraceLevelVerbosehodnotu , příklad vypíše druhou chybovou zprávu na stejném řádku jako první zpráva. Ukončovací znak řádku následuje za druhou zprávou.

// 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.
    Debug.WriteIf(generalSwitch.TraceError, "Invalid object for category. ");

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

Poznámky

Ve výchozím nastavení se výstup zapíše do instance DefaultTraceListener.

Parametr category lze použít k seskupení výstupních zpráv.

Tato metoda volá WriteLine metodu naslouchacího procesu trasování.

Poznámky pro dědice

Snížení výkonu instrumentace aplikace můžete minimalizovat pomocí If...Then příkazů namísto příkazů.WriteLineIf(Boolean, String) Následující dva příklady kódu odesílají stejnou zprávu ladění. První příklad je však mnohem rychlejší, když je trasování vypnuto, protože pokud je mySwitch.TraceError vyhodnoceno falsejako , nevyvoláte WriteLine(String). Druhý příklad vždy volá WriteLineIf(Boolean, String), i když mySwitch.TraceError je false a není vytvořen žádný výstup trasování. To může vést k zbytečnému spuštění libovolně složitého kódu.

První příklad:

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

Druhý příklad:

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

Viz také

Platí pro

WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zapíše zprávu do naslouchacích procesů trasování v Listeners kolekci, pokud je truezadaná podmínka .

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

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

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

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

Parametry

condition: Boolean

Podmíněný výraz, který se má vyhodnotit. Pokud je truepodmínka, zpráva se zapíše do naslouchacích procesů trasování v kolekci.

message: Debug.WriteIfInterpolatedStringHandler

Zpráva, kterou chcete napsat.

Atributy: ConditionalAttribute

Poznámky

Toto přetížení bylo zavedeno v .NET 6 za účelem zvýšení výkonu. Ve srovnání s přetíženími, které přebírají String parametr, toto přetížení vyhodnocuje pouze všechny interpolované položky formátování řetězců, pokud je zpráva povinná.

Ve výchozím nastavení se výstup zapíše do instance DefaultTraceListener.

Tato metoda volá TraceListener.WriteLine metodu naslouchacího procesu trasování.

Viz také

Platí pro

WriteLineIf(Boolean, Object)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zapíše hodnotu metody objektu ToString() do naslouchacích procesů trasování v Listeners kolekci, pokud je truepodmínka .

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

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

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

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

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

Parametry

condition: Boolean

Podmíněný výraz, který se má vyhodnotit. Pokud je truepodmínka , hodnota se zapíše do naslouchacích procesů trasování v kolekci.

value: Object

Objekt, jehož název je odeslán do objektu Listeners.

Atributy: ConditionalAttribute

Příklady

Následující příklad vytvoří pojmenovaný TraceSwitchgeneralSwitch. Tento přepínač je nastavený mimo vzorový kód.

Pokud je nastavena na TraceLevelVerbosehodnotu , příklad zobrazí název objektu na stejném řádku jako první zpráva. Ukončovací znak řádku následuje za druhou zprávou.

// 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, "Invalid object. ");

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

Poznámky

Ve výchozím nastavení se výstup zapíše do instance DefaultTraceListener.

Tato metoda volá WriteLine metodu naslouchacího procesu trasování.

Poznámky pro dědice

První příklad:

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

Druhý příklad:

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

Viz také

Platí pro

WriteLineIf(Boolean, String)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zapíše zprávu do naslouchacích procesů trasování v Listeners kolekci, pokud je truepodmínka .

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

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

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

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

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

Parametry

condition: Boolean

Podmíněný výraz, který se má vyhodnotit. Pokud je truepodmínka, zpráva se zapíše do naslouchacích procesů trasování v kolekci.

message: String

Zpráva, kterou chcete napsat.

Atributy: ConditionalAttribute

Příklady

Následující příklad vytvoří pojmenovaný TraceSwitchgeneralSwitch. Tento přepínač je nastavený mimo vzorový kód.

Pokud je nastavena na TraceLevelVerbosehodnotu , příklad vypíše druhou chybovou zprávu na stejném řádku jako první zpráva. Ukončovací znak řádku následuje za druhou zprávou.

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

Poznámky

Ve výchozím nastavení se výstup zapíše do instance DefaultTraceListener.

Tato metoda volá TraceListener.WriteLine metodu naslouchacího procesu trasování.

Poznámky pro dědice

První příklad:

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

Druhý příklad:

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

Viz také

Platí pro

WriteLineIf(Boolean, Debug+WriteIfInterpolatedStringHandler, String)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zapíše název kategorie a zprávu do naslouchacích procesů trasování v Listeners kolekci, pokud je truezadaná podmínka .

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

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

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

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

Parametry

condition: Boolean

Podmíněný výraz, který se má vyhodnotit. Pokud je truepodmínka , zpráva a název kategorie se zapisují do naslouchacích procesů trasování v kolekci.

message: Debug.WriteIfInterpolatedStringHandler

Zpráva, kterou chcete napsat.

category: String

Název kategorie sloužící k uspořádání výstupu.

Atributy: ConditionalAttribute

Poznámky

Ve výchozím nastavení se výstup zapíše do instance DefaultTraceListener.

Parametr category lze použít k seskupení výstupních zpráv.

Tato metoda volá TraceListener.WriteLine metodu naslouchacího procesu trasování.

Viz také

Platí pro

WriteLineIf(Boolean, String, String)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zapíše název kategorie a zprávu do naslouchacích procesů trasování v Listeners kolekci, pokud je truepodmínka .

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

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

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

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

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

Parametry

condition: Boolean

Podmíněný výraz, který se má vyhodnotit. Pokud je truepodmínka , zpráva a název cateogry se zapisují do naslouchacích procesů trasování v kolekci.

message: String

Zpráva, kterou chcete napsat.

category: String

Název kategorie sloužící k uspořádání výstupu.

Atributy: ConditionalAttribute

Příklady

Následující příklad vytvoří pojmenovaný TraceSwitchgeneralSwitch. Tento přepínač je nastavený mimo vzorový kód.

Pokud je nastavena na TraceLevelVerbosehodnotu , příklad vypíše druhou chybovou zprávu a category na stejném řádku jako první zpráva. Ukončovací znak řádku následuje za druhou zprávou.

// 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.
    Debug.WriteIf(generalSwitch.TraceError, "My error message. ");

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

Poznámky

Ve výchozím nastavení se výstup zapíše do instance DefaultTraceListener.

Parametr category lze použít k seskupení výstupních zpráv.

Tato metoda volá TraceListener.WriteLine metodu naslouchacího procesu trasování.

Poznámky pro dědice

První příklad:

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

Druhý příklad:

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

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?