Switch Constructors

Definition

Namespace:

System.Diagnostics

Assemblies:

netstandard.dll, System.Diagnostics.TraceSource.dll

Initializes a new instance of the Switch class.

Overloads

Switch(String, String)	Initializes a new instance of the Switch class.
Switch(String, String, String)	Initializes a new instance of the Switch class, specifying the display name, description, and default value for the switch.

Switch(String, String)

Source:

Switch.cs

Initializes a new instance of the Switch class.

C#

protected Switch(string displayName, string? description);

Parameters

displayName

String

The name of the switch.

description

String

The description for the switch.

Remarks

When you create a new Switch object, the value of the displayName parameter is used to find initial switch settings. The default value is an empty string ("").

Within the XML configuration file of a .NET Framework app, you can add a switch and set its value, remove a switch, or clear all the switches previously set by the application. Dynamic changes to the configuration file are not detected while the application is executing. You must stop and restart an application before changes to the configuration file take effect. The configuration file should be formatted like the following example:

XML

<configuration>  
  <system.diagnostics>  
    <switches>  
      <add name="mySwitch" value="10" />  
      <add name="myNewSwitch" value="20" />  
      <remove name="mySwitch" />  
      <clear/>  
    </switches>  
  </system.diagnostics>  
</configuration>  

Notes to Inheritors

To set the value of the switch, set the SwitchSetting property in the constructor.

See also

• Switch
• BooleanSwitch
• SourceSwitch
• TraceSwitch
• Debug
• Trace

Switch(String, String, String)

Source:

Switch.cs

Initializes a new instance of the Switch class, specifying the display name, description, and default value for the switch.

C#

protected Switch(string displayName, string? description, string defaultSwitchValue);

Parameters

displayName

String

The name of the switch.

description

String

The description of the switch.

defaultSwitchValue

String

The default value for the switch.

Remarks

The displayName parameter is used to set the value of the DisplayName property, and the description parameter is use to set the value of the Description property. The defaultSwitchValue parameter is the value for the switch if the Value property is not set by code or by the configuration file attribute. See the Switch(String, String) overload for additional information.