ConfigurationElementCollection.OnDeserializeUnrecognizedElement Method

Definition

Causes the configuration system to throw an exception.

protected override bool OnDeserializeUnrecognizedElement (string elementName, System.Xml.XmlReader reader);

Parameters

elementName
String

The name of the unrecognized element.

reader
XmlReader

An input stream that reads XML from the configuration file.

Returns

true if the unrecognized element was deserialized successfully; otherwise, false. The default is false.

Exceptions

The element specified in elementName is the <clear> element.

elementName starts with the reserved prefix "config" or "lock".

Remarks

The OnDeserializeUnrecognizedElement is called when an unrecognized configuration element is read from a configuration file.

Override this method to provide custom handling of unrecognized configuration elements from a configuration file. The default return value, false, causes the configuration system to throw an exception.

Applies to

Product Versies
.NET 8 (package-provided), 9 (package-provided)
.NET Framework 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 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9