ConfigurationElementCollection.OnDeserializeUnrecognizedElement Method

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Causes the configuration system to throw an exception.

protected:
 override bool OnDeserializeUnrecognizedElement(System::String ^ elementName, System::Xml::XmlReader ^ reader);

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

override this.OnDeserializeUnrecognizedElement : string * System.Xml.XmlReader -> bool

Protected Overrides Function OnDeserializeUnrecognizedElement (elementName As String, reader As XmlReader) As Boolean

Parameters

elementName

String

The name of the unrecognized element.

reader

XmlReader

An input stream that reads XML from the configuration file.

Returns

Boolean

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

Exceptions

ConfigurationErrorsException

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

ArgumentException

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.