BooleanSwitch Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.TraceSource.dll

Zdroj:

BooleanSwitch.cs

Poskytuje jednoduchý přepínač, 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í do MyMethod, který zobrazí chybovou zprávu a kde došlo k chybě.

public ref class BooleanSwitchTest
{
private:

   /* Create a BooleanSwitch for data.*/
   static BooleanSwitch^ dataSwitch = gcnew BooleanSwitch( "Data","DataAccess module" );

public:
   static void MyMethod( String^ location )
   {
      
      //Insert code here to handle processing.
      if ( dataSwitch->Enabled )
            Console::WriteLine( "Error happened at {0}", location );
   }

};

int main()
{
   
   //Run the method which writes an error message specifying the location of the error.
   BooleanSwitchTest::MyMethod( "in main" );
}

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

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

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

Pouze pro aplikace rozhraní .NET Framework můžete také povolit nebo zakázat BooleanSwitch prostřednictvím konfiguračního souboru aplikace a pak použít nakonfigurovanou BooleanSwitch hodnotu ve vaší aplikaci. Pokud chcete 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 formátovaný jako v následujícím příkladu.

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

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

private:
    static BooleanSwitch^ boolSwitch = gcnew BooleanSwitch("mySwitch",
        "Switch in config file");

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

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 ve výchozím nastavení nastavená na false .

U aplikací Enabled rozhraní .NET Framework se vlastnost nastaví pomocí hodnoty zadané v konfiguračním souboru. Nakonfigurujte přepínač s hodnotou 0, aby se vlastnost nastavil Enabled na false; nakonfigurujte přepínač s nenulovou hodnotou a nastavte Enabled vlastnost na true. BooleanSwitch Pokud konstruktor nemůže najít počáteční nastavení přepínače v konfiguračním Enabled souboru, 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 k kompilátoru.

• 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 do horní části 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í se při izolovaném BooleanSwitch používání třídy nevyžadují. Jsou vyžadovány pouze ve spojení s metodami Trace nebo Debug , které jsou podmíněně zkompilovány.

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

Poznámka

Pokud chcete zvýšit výkon, můžete ve třídě vytvořit BooleanSwitch členy static .

Konstruktory

BooleanSwitch(String, String)	Inicializuje novou instanci BooleanSwitch třídy se zadaným zobrazovaným názvem a popisem.
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.

Vlastnosti

Attributes	Získá vlastní atributy přepínače 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

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetSupportedAttributes()	Získá vlastní atributy podporované přepínačem. (Zděděno od Switch)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnSwitchSettingChanged()	Vyvoláno 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