TraceSwitch.OnSwitchSettingChanged Method

Definition

Updates and corrects the level for this switch.

C#
protected override void OnSwitchSettingChanged();

Remarks

The OnSwitchSettingChanged method is used by the .NET framework to validate and correct the value of a switch initialized via a configuration file. A message is written to all trace listeners if the switch value specified in the configuration file is not defined by the TraceLevel enumeration and the switch is set to a defined value.

If you attempt in your code to set the Level property to a value that is not defined by the TraceLevel enumeration, an ArgumentException exception is thrown.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

See also