NetDataContractSerializer.ReadObject 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.
Reads the XML stream or document and returns the deserialized object.
Overloads
| ReadObject(XmlReader) |
Reads the XML stream or document with an XmlDictionaryReader and returns the deserialized object. |
| ReadObject(XmlDictionaryReader, Boolean) |
Reads the XML stream or document with an XmlDictionaryReader and returns the deserialized object; also checks whether the object data conforms to the name and namespace used to create the serializer. |
| ReadObject(XmlReader, Boolean) |
Reads the XML stream or document with an XmlDictionaryReader and returns the deserialized object; also checks whether the object data conforms to the name and namespace used to create the serializer. |
Remarks
Important
Calling this method with untrusted data is a security risk. Call this method only with trusted data. For more information, see Validate All Inputs.
ReadObject(XmlReader)
Reads the XML stream or document with an XmlDictionaryReader and returns the deserialized object.
public:
override System::Object ^ ReadObject(System::Xml::XmlReader ^ reader);public override object ReadObject (System.Xml.XmlReader reader);override this.ReadObject : System.Xml.XmlReader -> objPublic Overrides Function ReadObject (reader As XmlReader) As ObjectParameters
Returns
The deserialized object.
Exceptions
the reader is set to null.
Remarks
Important
Calling this method with untrusted data is a security risk. Call this method only with trusted data. For more information, see Validate All Inputs.
Applies to
ReadObject(XmlDictionaryReader, Boolean)
Reads the XML stream or document with an XmlDictionaryReader and returns the deserialized object; also checks whether the object data conforms to the name and namespace used to create the serializer.
public:
override System::Object ^ ReadObject(System::Xml::XmlDictionaryReader ^ reader, bool verifyObjectName);public override object ReadObject (System.Xml.XmlDictionaryReader reader, bool verifyObjectName);override this.ReadObject : System.Xml.XmlDictionaryReader * bool -> objPublic Overrides Function ReadObject (reader As XmlDictionaryReader, verifyObjectName As Boolean) As ObjectParameters
- reader
- XmlDictionaryReader
The XmlDictionaryReader used to read the XML stream or document.
- verifyObjectName
- Boolean
true to check whether the enclosing XML element name and namespace correspond to the root name and root namespace used to construct the serializer; false to skip the verification.
Returns
The deserialized object.
Exceptions
the reader is set to null.
Remarks
The verifyObjectName parameter determines whether it can read an object by examining the name and namespace of the XML element the reader is positioned at, and comparing the values to expected name and namespace. The expected name and namespace can be set with the following: the data contract name and namespace of the type passed into the constructor, or the rootName and rootNamespace values passed into the constructor (if present).
You can set the rootName and rootNamespace in the following constructors: NetDataContractSerializer(String, String), NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString), and NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector).
Important
Calling this method with untrusted data is a security risk. Call this method only with trusted data. For more information, see Validate All Inputs.
Applies to
ReadObject(XmlReader, Boolean)
Reads the XML stream or document with an XmlDictionaryReader and returns the deserialized object; also checks whether the object data conforms to the name and namespace used to create the serializer.
public:
override System::Object ^ ReadObject(System::Xml::XmlReader ^ reader, bool verifyObjectName);public override object ReadObject (System.Xml.XmlReader reader, bool verifyObjectName);override this.ReadObject : System.Xml.XmlReader * bool -> objPublic Overrides Function ReadObject (reader As XmlReader, verifyObjectName As Boolean) As ObjectParameters
- verifyObjectName
- Boolean
true to check whether the enclosing XML element name and namespace correspond to the root name and root namespace used to construct the serializer; false to skip the verification.
Returns
The deserialized object.
Exceptions
the reader is set to null.
Remarks
The verifyObjectName parameter determines whether it can read an object by examining the name and namespace of the XML element the reader is positioned at, and comparing the values to expected name and namespace. The expected name and namespace can be set with the following: the data contract name and namespace of the type passed into the constructor, or the rootName and rootNamespace values passed into the constructor (if present).
You can set the rootName and rootNamespace in the following constructors: NetDataContractSerializer(String, String), NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString), and NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector).
Important
Calling this method with untrusted data is a security risk. Call this method only with trusted data. For more information, see Validate All Inputs.
