BooleanSwitch Třída

Definice

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.

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í.

Konstruktory

Vlastnosti

Metody

Platí pro

Viz také

• Switch
• TraceSwitch
• Debug
• Trace