System.Xml.Serialization.XmlSerializer.Deserialize Method

Deserializes the XML document contained by the specified System.IO.TextReader.

Syntax

public object Deserialize (System.IO.TextReader textReader)

Parameters

textReader
The System.IO.TextReader that contains the XML document to deserialize.

Returns

The object being deserialized.

Remarks

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 System.Xml.Serialization.XmlSerializer must be constructed using the type of the object that is being deserialized.

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

Note:

To use the encoding specified by the XML document, use the XmlSerializer.Deserialize(System.IO.Stream) overload that takes an System.Xml.XmlReader instead. The System.Xml.XmlReader automatically detects and uses the encoding specified by the XML document.

Note:

The System.Xml.Serialization.XmlSerializer cannot deserialize the following: arrays of ArrayList and arrays of List`1.

Requirements

Namespace: System.Xml.Serialization
Assembly: System.Xml (in System.Xml.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0