C# in a Nutshell, Second Edition

Name

Switch

Synopsis

Consult this class in a conditional statement to execute special tracing or debugging code. To use a switch you must have debugging enabled. Each Switch has a DisplayName and Description. SwitchSetting contains the current setting.

Specify the value of a switch in the application configuration file. Under the <system.diagnostics> element, add an element <switches> to hold all the switches. Within the <switches> element, define each switch you want with <add name="switchname" value="value"/>. For a BooleanSwitch, any nonzero value sets BooleanSwitch.Enabled to true. For a TraceSwitch, use a value from the TraceLevel enumeration.

public abstract class Switch {
// Protected Constructors
   protected Switch(string displayName, string description);
// Public Instance Properties
   public string Description{get; }
   public string DisplayName{get; }
// Protected Instance Properties
   protected int SwitchSetting{set; get; }
// Protected Instance Methods
   protected virtual void OnSwitchSettingChanged( );
}

Subclasses

BooleanSwitch, TraceSwitch