BooleanSwitch Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.TraceSource.dll

Kaynak:

BooleanSwitch.cs

Hata ayıklama ve izleme çıkışını denetleyen basit bir açma/kapatma düğmesi sağlar.

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

public class BooleanSwitch : System.Diagnostics.Switch

type BooleanSwitch = class
    inherit Switch

Public Class BooleanSwitch
Inherits Switch

Devralma

Object

Switch

BooleanSwitch

Örnekler

Aşağıdaki örnek, bir hata iletisinin yazdırılıp yazdırılmayacağını belirlemek için bir BooleanSwitch oluşturur ve anahtarını kullanır. Anahtarı sınıf düzeyinde oluşturursunuz. yöntemi, Main bir hata iletisi yazdıran ve hatanın oluştuğu konumuna MyMethodgeçirir.

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

Açıklamalar

İletileri önem derecelerine göre etkinleştirmek veya devre dışı bırakmak için Boole izleme anahtarı kullanabilirsiniz. anahtarının Enabled geçerli değerini almak için özelliğini kullanın.

Kodunuzda bir BooleanSwitch oluşturabilir ve özelliğini doğrudan kodun Enabled belirli bir bölümünü izlemesi için ayarlayabilirsiniz.

Yalnızca .NET Framework uygulamalar için, uygulama yapılandırma dosyası aracılığıyla bir'i BooleanSwitch etkinleştirebilir veya devre dışı bırakabilir ve ardından uygulamanızda yapılandırılan BooleanSwitch değeri kullanabilirsiniz. yapılandırmak BooleanSwitchiçin, uygulamanızın adına karşılık gelen yapılandırma dosyasını düzenleyin. Bu dosyanın içinde bir anahtar ekleyebilir veya kaldırabilir, anahtarın değerini ayarlayabilir veya uygulama tarafından daha önce ayarlanan tüm anahtarları temizleyebilirsiniz. Yapılandırma dosyası aşağıdaki örnekte olduğu gibi biçimlendirilmelidir.

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

Bu örnek yapılandırma bölümü, özelliğinin ve mySwitch değerinin EnabledDisplayName olarak ayarlandığı truebir BooleanSwitch öğesini tanımlar. .NET Framework uygulamanızın içinde, aşağıdaki kod örneğinde gösterildiği gibi aynı ada sahip bir BooleanSwitch oluşturarak yapılandırılan anahtar değerini kullanabilirsiniz.

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

.NET Core ve .NET 5+ uygulamaları için yeni Enabled anahtarın özelliği varsayılan olarak olarak ayarlanır false .

.NET Framework uygulamalar için özelliği, Enabled yapılandırma dosyasında belirtilen değer kullanılarak ayarlanır. özelliğini olarak ayarlamak için anahtarını 0 değeriyle yapılandırın; özelliğini falseolarak ayarlamak trueEnabledEnabled için anahtarı sıfır olmayan bir değerle yapılandırın. Oluşturucu yapılandırma BooleanSwitch dosyasında ilk anahtar ayarlarını bulamazsa, yeni anahtarın Enabled özelliği olarak falseayarlanır.

Anahtar kullanmak için izlemeyi veya hata ayıklamayı etkinleştirmeniz gerekir. Aşağıdaki söz dizimi derleyiciye özgüdür. C# veya Visual Basic dışında derleyiciler kullanıyorsanız, derleyicinizin belgelerine bakın.

• C# dilinde hata ayıklamayı etkinleştirmek için, /d:DEBUG kodunuzu derlerken derleyici komut satırına bayrağını ekleyin veya dosyanızın en üstüne ekleyebilirsiniz #define DEBUG . Visual Basic'te, bayrağını /d:DEBUG=True derleyici komut satırına ekleyin.

• C# dilinde izlemeyi etkinleştirmek için, /d:TRACE kodunuzu derlerken derleyici komut satırına bayrağını ekleyin veya dosyanızın en üstüne ekleyin #define TRACE . Visual Basic'te, bayrağını /d:TRACE=True derleyici komut satırına ekleyin.

Not

Sınıfı yalıtılırken BooleanSwitch bu hata ayıklama ve izleme derleyicisi anahtarları gerekli değildir. Bunlar yalnızca koşullu olarak derlenen veya Debug yöntemleriyle Trace birlikte gereklidir.

Uygulamanızı izleme hakkında daha fazla bilgi için bkz Debug . ve Trace. İzleme anahtarlarını yapılandırma ve kullanma hakkında daha fazla bilgi için bkz. İzleme Anahtarları.

Not

Performansı geliştirmek için sınıfınızdaki üyeleri static oluşturabilirsinizBooleanSwitch.

Oluşturucular

BooleanSwitch(String, String)	Belirtilen görünen ad ve açıklama ile sınıfının yeni bir örneğini BooleanSwitch başlatır.
BooleanSwitch(String, String, String)	Belirtilen görünen ad, açıklama ve varsayılan anahtar değeriyle sınıfının yeni bir örneğini BooleanSwitch başlatır.

Özellikler

Attributes	Uygulama yapılandırma dosyasında tanımlanan özel anahtar özniteliklerini alır. (Devralındığı yer: Switch)
DefaultValue	Oluşturucuda atanan varsayılan değeri alır. (Devralındığı yer: Switch)
Description	Anahtarın açıklamasını alır. (Devralındığı yer: Switch)
DisplayName	Anahtarı tanımlamak için kullanılan bir ad alır. (Devralındığı yer: Switch)
Enabled	Anahtarın etkinleştirildiğini veya devre dışı bırakıldığını belirten bir değer alır veya ayarlar.
SwitchSetting	Bu anahtar için geçerli ayarı alır veya ayarlar. (Devralındığı yer: Switch)
Value	Anahtarın değerini alır veya ayarlar. (Devralındığı yer: Switch)

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetSupportedAttributes()	Anahtar tarafından desteklenen özel öznitelikleri alır. (Devralındığı yer: Switch)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnSwitchSettingChanged()	Özellik değiştirildiğinde SwitchSetting çağrılır. (Devralındığı yer: Switch)
OnValueChanged()	Özelliğin yeni değerinin Value Boole değeri olarak ayrıştırılıp ayrıştırılamayacağını belirler.
Refresh()	İzleme yapılandırma verilerini yeniler. (Devralındığı yer: Switch)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Switch
• TraceSwitch
• Debug
• Trace