ConfigurationElementCollection.OnDeserializeUnrecognizedElement Method (String, XmlReader)

 
System_CAPS_noteNote

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

Causes the configuration system to throw an exception.

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

protected override bool OnDeserializeUnrecognizedElement(
	string elementName,
	XmlReader reader
)

Parameters

elementName
Type: System.String

The name of the unrecognized element.

reader
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
ConfigurationErrorsException

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

ArgumentException

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
Show: