ConfigurationElementCollection.OnDeserializeUnrecognizedElement Method (String, XmlReader)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Causes the configuration system to throw an exception.

Namespace:   System.Configuration
Assembly:  System.Configuration (in System.Configuration.dll)

override OnDeserializeUnrecognizedElement : 
        elementName:string *
        reader:XmlReader -> bool


Type: System.String

The name of the unrecognized element.

Type: System.Xml.XmlReader

An input stream that reads XML from the configuration file.

Return Value

Type: System.Boolean

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

Exception Condition

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


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

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.

.NET Framework
Available since 2.0
Return to top