.NET Framework Class Library
ConfigurationElementOnDeserializeUnrecognizedElement Method

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

Namespace:   System.Configuration
Assembly:  System.Configuration (in System.Configuration.dll)
Protected Overridable Function OnDeserializeUnrecognizedElement ( _
	elementName As [%$TOPIC/ms134132_en-us_VS_110_1_0_0_0_0%], _
	reader As [%$TOPIC/ms134132_en-us_VS_110_1_0_0_0_1%] _
) As [%$TOPIC/ms134132_en-us_VS_110_1_0_0_0_2%]
protected virtual [%$TOPIC/ms134132_en-us_VS_110_1_0_1_0_0%] OnDeserializeUnrecognizedElement(
	[%$TOPIC/ms134132_en-us_VS_110_1_0_1_0_1%] elementName,
	[%$TOPIC/ms134132_en-us_VS_110_1_0_1_0_2%] reader
virtual [%$TOPIC/ms134132_en-us_VS_110_1_0_2_0_0%] OnDeserializeUnrecognizedElement(
	[%$TOPIC/ms134132_en-us_VS_110_1_0_2_0_1%]^ elementName, 
	[%$TOPIC/ms134132_en-us_VS_110_1_0_2_0_2%]^ reader
abstract OnDeserializeUnrecognizedElement : 
        elementName:[%$TOPIC/ms134132_en-us_VS_110_1_0_3_0_0%] * 
        reader:[%$TOPIC/ms134132_en-us_VS_110_1_0_3_0_1%] -> [%$TOPIC/ms134132_en-us_VS_110_1_0_3_0_2%]  
override OnDeserializeUnrecognizedElement : 
        elementName:[%$TOPIC/ms134132_en-us_VS_110_1_0_3_0_3%] * 
        reader:[%$TOPIC/ms134132_en-us_VS_110_1_0_3_0_4%] -> [%$TOPIC/ms134132_en-us_VS_110_1_0_3_0_5%]


Type: SystemString

The name of the unknown subelement.

Type: System.XmlXmlReader

The XmlReader being used for deserialization.

Return Value

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

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.


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

Version Information

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.