BooleanSwitch Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.TraceSource.dll

Kaynak:

BooleanSwitch.cs

Hata ayıklamayı ve izleme çıkışını denetleen basit bir açma/kapatma anahtarı 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 BooleanSwitch oluşturur ve bir hata iletisinin yazdırılıp yazdırılmayacağını belirlemek için anahtarını kullanır. Anahtarı sınıf düzeyinde oluşturursunuz. Main yöntemi, konumunu bir hata iletisi yazdıran ve hatanın oluştuğu yeri yazdıran 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

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

Kodunuzda bir BooleanSwitch oluşturabilir ve Enabled özelliğini doğrudan kodun 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 BooleanSwitch etkinleştirebilir veya devre dışı bırakabilir ve ardından uygulamanızda yapılandırılmış BooleanSwitch değerini kullanabilirsiniz. BooleanSwitchyapılandırmak iç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ü, DisplayName özelliği mySwitch ve Enabled değeri trueolarak ayarlanmış bir BooleanSwitch tanımlar. .NET Framework uygulamanızda, 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 anahtarın Enabled özelliği varsayılan olarak false olarak ayarlanır.

.NET Framework uygulamaları için Enabled özelliği yapılandırma dosyasında belirtilen değer kullanılarak ayarlanır. Enabled özelliğini falseolarak ayarlamak için anahtarı 0 değeriyle yapılandırın; Enabled özelliğini trueolarak ayarlamak için anahtarı sıfır olmayan bir değerle yapılandırın. BooleanSwitch oluşturucu yapılandırma dosyasında ilk anahtar ayarlarını bulamazsa, yeni anahtarın Enabled özelliği falseolarak ayarlanı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 kodunuzu derlerken derleyici komut satırına /d:DEBUG bayrağını ekleyin veya dosyanızın en üstüne #define DEBUG ekleyebilirsiniz. Visual Basic'te, derleyici komut satırına /d:DEBUG=True bayrağını ekleyin.

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

Not

BooleanSwitch sınıfı yalıtılırken bu hata ayıklama ve izleme derleyicisi anahtarları gerekli değildir. Bunlar yalnızca koşullu olarak derlenmiş Trace veya Debug yöntemleriyle 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ı artırmak için BooleanSwitch üyeleri sınıfınızda static yapabilirsiniz.

Oluşturucular

BooleanSwitch(String, String, String)	Belirtilen görünen ad, açıklama ve varsayılan anahtar değeriyle BooleanSwitch sınıfının yeni bir örneğini başlatır.
BooleanSwitch(String, String)	Belirtilen görünen ad ve açıklama ile BooleanSwitch sınıfının yeni bir örneğini 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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnSwitchSettingChanged()	SwitchSetting özelliği değiştirildiğinde çağrılır. (Devralındığı yer: Switch)
OnValueChanged()	Value özelliğinin yeni değerinin 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 bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Switch
• TraceSwitch
• Debug
• Trace