BooleanSwitch Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.TraceSource.dll

Zdroj:

BooleanSwitch.cs

Poskytuje jednoduchý přepínač zapnuto/vypnuto, který řídí výstup ladění a trasování.

public ref class BooleanSwitch : System::Diagnostics::Switch

public class BooleanSwitch : System.Diagnostics.Switch

type BooleanSwitch = class
    inherit Switch

Public Class BooleanSwitch
Inherits Switch

Dědičnost

Object

Switch

BooleanSwitch

Příklady

Následující příklad vytvoří BooleanSwitch a použije přepínač k určení, zda se má vytisknout chybová zpráva. Přepínač vytvoříte na úrovni třídy. Metoda Main předá své umístění MyMethod, která vytiskne chybovou zprávu a kde došlo k chybě.

// Class level declaration.
/* Create a BooleanSwitch for data.*/
static BooleanSwitch dataSwitch = new BooleanSwitch("Data", "DataAccess module");

static public void MyMethod(string location)
{
    //Insert code here to handle processing.
    if (dataSwitch.Enabled)
        Console.WriteLine("Error happened at " + location);
}

public static void Main(string[] args)
{
    //Run the method which writes an error message specifying the location of the error.
    MyMethod("in Main");
}

' Class level declaration.
' Create a BooleanSwitch for data. 
Private Shared dataSwitch As New BooleanSwitch("Data", "DataAccess module")


Public Shared Sub MyMethod(location As String)
    ' Insert code here to handle processing.
    If dataSwitch.Enabled Then
        Console.WriteLine(("Error happened at " + location))
    End If
End Sub

' Entry point which delegates to C-style main function.
Public Overloads Shared Sub Main()
    Main(System.Environment.GetCommandLineArgs())
End Sub
 
Overloads Public Shared Sub Main(args() As String)
    ' Run the method which writes an error message specifying the location of the error.
    MyMethod("in Main")
End Sub

Poznámky

K povolení nebo zakázání zpráv na základě jejich důležitosti můžete použít přepínač logického trasování. Enabled Pomocí vlastnosti získáte aktuální hodnotu přepínače.

V kódu můžete vytvořit objekt BooleanSwitch a nastavit Enabled vlastnost přímo na instrumentaci konkrétní části kódu.

Pouze pro aplikace .NET Framework můžete povolit nebo zakázat BooleanSwitch prostřednictvím konfiguračního souboru aplikace a pak použít nakonfigurovanou BooleanSwitch hodnotu ve vaší aplikaci. Chcete-li nakonfigurovat BooleanSwitch, upravte konfigurační soubor, který odpovídá názvu vaší aplikace. V tomto souboru můžete přidat nebo odebrat přepínač, nastavit hodnotu přepínače nebo vymazat všechny přepínače dříve nastavené aplikací. Konfigurační soubor by měl být naformátovaný jako v následujícím příkladu.

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="1"/>
    </switches>
  </system.diagnostics>
</configuration>

Tento příklad konfigurační oddíl definuje BooleanSwitch s DisplayName vlastností nastavenou mySwitch na a hodnotu nastavenou Enabled na true. V rámci aplikace .NET Framework můžete použít nakonfigurovanou hodnotu přepínače vytvořením se BooleanSwitch stejným názvem, jak je znázorněno v následujícím příkladu kódu.

private static BooleanSwitch boolSwitch = new BooleanSwitch("mySwitch",
    "Switch in config file");

public static void Main()
{
    //...
    Console.WriteLine("Boolean switch {0} configured as {1}",
        boolSwitch.DisplayName, boolSwitch.Enabled.ToString());
    if (boolSwitch.Enabled)
    {
        //...
    }
}

Private Shared boolSwitch As new BooleanSwitch("mySwitch", _
    "Switch in config file")

Public Shared Sub Main( )
    '...
    Console.WriteLine("Boolean switch {0} configured as {1}",
        boolSwitch.DisplayName, boolSwitch.Enabled.ToString())
    If boolSwitch.Enabled = True Then
        '...
    End If
End Sub

U aplikací Enabled .NET Core a .NET 5+ je vlastnost nového přepínače nastavená false ve výchozím nastavení.

U aplikací Enabled rozhraní .NET Framework je vlastnost nastavena pomocí hodnoty zadané v konfiguračním souboru. Nakonfigurujte přepínač s hodnotou 0 a nastavte Enabled vlastnost na false; nakonfigurujte přepínač s nenulovou hodnotou pro nastavení Enabled vlastnosti na true. BooleanSwitch Pokud konstruktor nemůže najít počáteční nastavení přepínače v konfiguračním souboru, Enabled vlastnost nového přepínače je nastavena na false.

Pokud chcete použít přepínač, musíte povolit trasování nebo ladění. Následující syntaxe je specifická pro kompilátor. Pokud používáte jiné kompilátory než C# nebo Visual Basic, projděte si dokumentaci pro váš kompilátor.

• Pokud chcete povolit ladění v jazyce C#, přidejte /d:DEBUG příznak do příkazového řádku kompilátoru při kompilaci kódu nebo můžete přidat #define DEBUG na začátek souboru. V jazyce Visual Basic přidejte /d:DEBUG=True příznak do příkazového řádku kompilátoru.

• Pokud chcete povolit trasování v jazyce C#, přidejte /d:TRACE příznak do příkazového řádku kompilátoru při kompilaci kódu nebo přidejte #define TRACE na začátek souboru. V jazyce Visual Basic přidejte /d:TRACE=True příznak do příkazového řádku kompilátoru.

Poznámka:

Tyto přepínače kompilátoru ladění a trasování nejsou vyžadovány při použití BooleanSwitch třídy v izolaci. Jsou vyžadovány pouze ve spojení s metodami TraceDebug , které jsou podmíněně zkompilovány.

Další informace o instrumentaci aplikace naleznete Debug a Trace. Další informace o konfiguraci a používání přepínačů trasování naleznete v tématu Přepínače trasování.

Poznámka:

Pokud chcete zvýšit výkon, můžete členy ve třídě vytvářet BooleanSwitchstatic .

Konstruktory

Name	Description
BooleanSwitch(String, String, String)	Inicializuje novou instanci BooleanSwitch třídy se zadaným zobrazovaným názvem, popisem a výchozí hodnotou přepínače.
BooleanSwitch(String, String)	Inicializuje novou instanci BooleanSwitch třídy se zadaným zobrazovaným názvem a popisem.

Vlastnosti

Name	Description
Attributes	Získá vlastní přepínače atributy definované v konfiguračním souboru aplikace. (Zděděno od Switch)
DefaultValue	Získá výchozí hodnotu přiřazenou v konstruktoru. (Zděděno od Switch)
Description	Získá popis přepínače. (Zděděno od Switch)
DisplayName	Získá název použitý k identifikaci přepínače. (Zděděno od Switch)
Enabled	Získá nebo nastaví hodnotu označující, zda je přepínač povolen nebo zakázán.
SwitchSetting	Získá nebo nastaví aktuální nastavení pro tento přepínač. (Zděděno od Switch)
Value	Získá nebo nastaví hodnotu přepínače. (Zděděno od Switch)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetSupportedAttributes()	Získá vlastní atributy podporované přepínačem. (Zděděno od Switch)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnSwitchSettingChanged()	Vyvolána při SwitchSetting změně vlastnosti. (Zděděno od Switch)
OnValueChanged()	Určuje, zda lze novou hodnotu Value vlastnosti analyzovat jako logickou hodnotu.
Refresh()	Aktualizuje konfigurační data trasování. (Zděděno od Switch)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Switch
• TraceSwitch
• Debug
• Trace