BooleanSwitch BooleanSwitch BooleanSwitch BooleanSwitch Class

정의

디버깅 및 추적 출력을 제어하는 간단한 켜기/끄기 스위치를 제공합니다.Provides a simple on/off switch that controls debugging and tracing output.

public ref class BooleanSwitch : System::Diagnostics::Switch
public class BooleanSwitch : System.Diagnostics.Switch
type BooleanSwitch = class
    inherit Switch
Public Class BooleanSwitch
Inherits Switch
상속
BooleanSwitchBooleanSwitchBooleanSwitchBooleanSwitch

예제

다음 예제에서는 BooleanSwitch 스위치를 사용 하는 오류 메시지를 출력할 것인지 여부를 결정 합니다.The following example creates a BooleanSwitch and uses the switch to determine whether to print an error message. 클래스 수준에서 스위치를 만드세요.You create the switch at the class level. 합니다 Main 메서드를 위치로 전달 MyMethod오류 메시지를 인쇄 하 고 오류가 발생 합니다.The Main method passes its location to MyMethod, which prints an error message and where the error occurred.

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

설명

중요도에 따라 메시지를 사용할지 여부를 Boolean 추적 스위치를 사용할 수 있습니다.You can use a Boolean trace switch to enable or disable messages based on their importance. 사용 된 Enabled 스위치의 현재 값을 검색할 속성입니다.Use the Enabled property to get the current value of the switch.

활성화 하거나 비활성화할 수는 BooleanSwitch 애플리케이션 구성 파일을 사용 하 여 구성된 된 통해 BooleanSwitch 애플리케이션의 값입니다.You can enable or disable a BooleanSwitch through the application configuration file and then use the configured BooleanSwitch value in your application. 또는 만들 수 있습니다는 BooleanSwitch 설정 하 여 코드에는 Enabled 계측 코드의 특정 섹션에 직접 속성입니다.Alternately, you can create a BooleanSwitch in your code and set the Enabled property directly to instrument a specific section of code.

구성 하는 BooleanSwitch, 애플리케이션의 이름에 해당 하는 구성 파일을 편집 합니다.To configure a BooleanSwitch, edit the configuration file that corresponds to the name of your application. 이 파일에 있습니다 수 추가 또는 제거 스위치를, 스위치의 값을 설정 하거나 스위치 애플리케이션에서 이전에 설정한 모든 선택을 취소 합니다.Within this file, you can add or remove a switch, set a switch's value, or clear all the switches previously set by the application. 다음 예제와 같이 구성 파일의 형식은 같아야 합니다.The configuration file should be formatted like the following example.

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

이 예제에서는 구성 섹션 정의 BooleanSwitch 사용 하 여는 DisplayName 속성이로 설정 mySwitch 하며 Enabled 값으로 설정 true합니다.This example configuration section defines a BooleanSwitch with the DisplayName property set to mySwitch and the Enabled value set to true. 애플리케이션 내에서 만들어 구성 된 스위치 값을 사용할 수 있습니다는 BooleanSwitch 다음 코드 예제와 같이 동일한 이름을 사용 합니다.Within your application, you can use the configured switch value by creating a BooleanSwitch with the same name, as shown in the following code example.

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

기본적으로 Enabled 구성 파일에 지정 된 값을 사용 하 여 속성을 설정 합니다.By default, the Enabled property is set using the value specified in the configuration file. 스위치를 설정 하려면 0 값으로 구성 합니다 Enabled 속성을 false; 스위치를 설정 하려면 0이 아닌 값을 사용 하 여 구성 합니다 Enabled 속성을 true.Configure the switch with a value of 0 to set the Enabled property to false; configure the switch with a nonzero value to set the Enabled property to true. 경우는 BooleanSwitch 생성자는 구성 파일에서 초기 스위치 설정을 찾을 수 없습니다 합니다 Enabled 새 스위치의 속성 false 기본적으로 합니다.If the BooleanSwitch constructor cannot find initial switch settings in the configuration file, the Enabled property of the new switch is set to false by default.

추적 또는 디버깅 스위치를 사용 하도록 설정 해야 합니다.You must enable tracing or debugging to use a switch. 다음 구문은 특정 컴파일러입니다.The following syntax is compiler specific. C# 또는 Visual Basic 이외의 컴파일러를 사용 하면 컴파일러에 대 한 설명서를 참조 합니다.If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • C# 디버깅을 사용 하려면 다음을 추가 합니다 /d:DEBUG 플래그를 추가할 수 있습니다 하거나 코드를 컴파일할 때 컴파일러 명령줄 #define DEBUG 파일의 맨 위로 이동 합니다.To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or you can add #define DEBUG to the top of your file. Visual Basic에서 추가 된 /d:DEBUG=True 컴파일러 명령줄 플래그입니다.In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.

  • C#에서 추적을 사용 하려면 추가 합니다 /d:TRACE 코드를 컴파일할 때 컴파일러 명령줄 플래그 #define TRACE 파일의 맨 위로 이동 합니다.To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. Visual Basic에서 추가 된 /d:TRACE=True 컴파일러 명령줄 플래그입니다.In Visual Basic, add the /d:TRACE=True flag to the compiler command line.

참고

이러한 디버그 하 고 사용 하는 경우 추적 컴파일러 스위치 필요 하지 않습니다는 BooleanSwitch 격리의 클래스입니다.These debug and trace compiler switches are not required when using the BooleanSwitch class in isolation. 와 함께 필요한 Trace 또는 Debug 메서드는 조건부로 컴파일됩니다.They are only required in conjunction with Trace or Debug methods that are conditionally compiled.

애플리케이션을 계측 하는 방법은 참조 하세요 DebugTrace입니다.For more information on instrumenting your application, see Debug and Trace. 구성 및 추적 스위치를 사용 하는 방법에 대 한 자세한 내용은 참조 하세요. 추적 스위치합니다.For more information about configuring and using trace switches, see Trace Switches.

참고

성능 향상을 위해 할 수 있습니다 BooleanSwitch 멤버 static 클래스에서입니다.To improve performance, you can make BooleanSwitch members static in your class.

생성자

BooleanSwitch(String, String) BooleanSwitch(String, String) BooleanSwitch(String, String) BooleanSwitch(String, String)

지정된 표시 이름 및 설명을 사용하여 BooleanSwitch 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the BooleanSwitch class with the specified display name and description.

BooleanSwitch(String, String, String) BooleanSwitch(String, String, String) BooleanSwitch(String, String, String) BooleanSwitch(String, String, String)

지정된 표시 이름, 설명 및 기본 스위치 값을 사용하여 BooleanSwitch 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the BooleanSwitch class with the specified display name, description, and default switch value.

속성

Attributes Attributes Attributes Attributes

애플리케이션 구성 파일에 정의된 사용자 지정 스위치 특성을 가져옵니다.Gets the custom switch attributes defined in the application configuration file.

(Inherited from Switch)
Description Description Description Description

스위치에 대한 설명을 가져옵니다.Gets a description of the switch.

(Inherited from Switch)
DisplayName DisplayName DisplayName DisplayName

스위치를 식별하는 데 사용되는 이름을 가져옵니다.Gets a name used to identify the switch.

(Inherited from Switch)
Enabled Enabled Enabled Enabled

스위치가 활성화되는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the switch is enabled or disabled.

SwitchSetting SwitchSetting SwitchSetting SwitchSetting

이 스위치의 현재 설정을 가져오거나 설정합니다.Gets or sets the current setting for this switch.

(Inherited from Switch)
Value Value Value Value

스위치의 값을 가져오거나 설정합니다.Gets or sets the value of the switch.

(Inherited from Switch)

메서드

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes() GetSupportedAttributes()

스위치에서 지원하는 사용자 지정 특성을 가져옵니다.Gets the custom attributes supported by the switch.

(Inherited from Switch)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
OnSwitchSettingChanged() OnSwitchSettingChanged() OnSwitchSettingChanged() OnSwitchSettingChanged()

SwitchSetting 속성이 변경될 때 호출됩니다.Invoked when the SwitchSetting property is changed.

(Inherited from Switch)
OnValueChanged() OnValueChanged() OnValueChanged() OnValueChanged()

Value 속성의 새 값을 부울 값으로 구문 분석할 수 있는지 여부를 결정합니다.Determines whether the new value of the Value property can be parsed as a Boolean value.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

적용 대상

추가 정보