ConfigurationElement.OnDeserializeUnrecognizedElement Method

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Gets a value indicating whether an unknown element is encountered during deserialization.

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

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

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

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

Parameters

elementName

String

The name of the unknown subelement.

reader

XmlReader

The XmlReader being used for deserialization.

Returns

Boolean

true when an unknown element is encountered while deserializing; otherwise, false.

Exceptions

ConfigurationErrorsException

The element identified by elementName is locked.

-or-

One or more of the element's attributes is locked.

-or-

elementName is unrecognized, or the element has an unrecognized attribute.

-or-

The element has a Boolean attribute with an invalid value.

-or-

An attempt was made to deserialize a property more than once.

-or-

An attempt was made to deserialize a property that is not a valid member of the element.

-or-

The element cannot contain a CDATA or text element.

Remarks

The OnDeserializeUnrecognizedElement is invoked when an unknown attribute is encountered while deserializing the ConfigurationElement object.