Debug.WriteIf Metoda

Definice

Obor názvů:: System.Diagnostics

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

Sestavení:: System.dll, System.Diagnostics.Debug.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
WriteIf(Boolean, Debug+WriteIfInterpolatedStringHandler)	Pokud `condition` ano `true`, zapíše název kategorie a zprávu do naslouchacích procesů trasování v kolekci Listeners .
WriteIf(Boolean, Object)	Zapíše hodnotu metody objektu ToString() do naslouchacích procesů trasování v Listeners kolekci, pokud je `true`podmínka .
WriteIf(Boolean, String)	Zapíše zprávu do naslouchacích procesů trasování v Listeners kolekci, pokud je `true`podmínka .
WriteIf(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 .
WriteIf(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 .
WriteIf(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 .

WriteIf(Boolean, Debug+WriteIfInterpolatedStringHandler)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Pokud condition ano true, zapíše název kategorie a zprávu do naslouchacích procesů trasování v kolekci Listeners .

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)

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.

message: Debug.WriteIfInterpolatedStringHandler

Zpráva, která se má napsat, pokud condition je true.

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.

Pomocí parametru category seskupte výstupní zprávy.

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

Viz také

Platí pro

WriteIf(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 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)

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 přepínač nastavený na TraceLevelError hodnotu nebo vyšší, v příkladu se vypíše křestní název parametru hodnoty do parametru Listeners. Informace o přidání naslouchacího Listeners procesu do kolekce najdete v TraceListenerCollection třídě.

Pokud je nastavena na TraceLevelVerbosehodnotu , příklad zobrazí 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)
{
    // 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

Poznámky

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

Tato metoda volá Write 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ů.WriteIf(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 Write(String). Druhý příklad vždy volá WriteIf(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.Write("aNumber = " + aNumber + " out of range");

Druhý příklad:

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

Viz také

Platí pro

WriteIf(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 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)

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, která se má 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 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 naleznete ve 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.
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

Poznámky

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

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

Poznámky pro dědice

První příklad:

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

Druhý příklad:

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

Viz také

Platí pro

WriteIf(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 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)

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.

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.

Pomocí parametru category seskupte výstupní zprávy.

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

Viz také

Platí pro

WriteIf(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 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)

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 TraceLevelVerbose, příklad výstupu název myObject a category na Listeners. Informace o přidání naslouchacího Listeners procesu do kolekce najdete v TraceListenerCollection třídě.

Pokud je nastavená TraceLevel na Error nebo vyšší, zobrazí se v příkladu druhá chybová zpráva 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 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

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á Write metodu naslouchacího procesu trasování.

Poznámky pro dědice

První příklad:

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

Druhý příklad:

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

Viz také

Platí pro

WriteIf(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 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)

Parametry

condition: Boolean

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

message: String

Zpráva, která se má 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 přepínač nastaven na TraceLevelVerbosehodnotu , příklad vypíše první chybovou Listenerszprávu do . Informace o přidání naslouchacího Listeners procesu do kolekce najdete v TraceListenerCollection třídě.

// 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

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.Write metodu naslouchacího procesu trasování.

Poznámky pro dědice

První příklad:

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

Druhý příklad:

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

Viz také

Platí pro

Váš názor

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