ConfigurationElementCollection.OnDeserializeUnrecognizedElement Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
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.