XmlSerializer.Deserialize Method (TextReader)

 

Deserializes the XML document contained by the specified TextReader.

Namespace:   System.Xml.Serialization
Assembly:  System.Xml (in System.Xml.dll)

member Deserialize : 
        textReader:TextReader -> Object

Parameters

textReader
Type: System.IO.TextReader

The TextReader that contains the XML document to deserialize.

Return Value

Type: System.Object

The Object being deserialized.

Exception Condition
InvalidOperationException

An error occurred during deserialization. The original exception is available using the InnerException property.

Deserialization is the process of reading an instance of an XML document and constructing an object that is strongly typed to the XML Schema (XSD) of the document.

Before deserializing, an XmlSerializer must be constructed using the type of the object that is being deserialized.

Classes that inherit from TextReader include StringReader and StreamReader. If you are using a StreamReader to deserialize an object, you must construct the StreamReader with an appropriate Encoding. The encoding specified by the XML document is ignored.

System_CAPS_noteNote

To use the encoding specified by the XML document, use the Deserialize overload that takes an XmlReader instead. The XmlReader automatically detects and uses the encoding specified by the XML document.

System_CAPS_noteNote

The XmlSerializer cannot deserialize the following: arrays of ArrayList and arrays of List<'T>.

The following example deserializes an object using a TextReader object.

No code example is currently available or this language may not be supported.

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: