Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

XmlObjectSerializer::IsStartObject Method (XmlDictionaryReader)

Gets a value that specifies whether the XmlDictionaryReader is positioned over an XML element that can be read.

Namespace:  System.Runtime.Serialization
Assemblies:   System.Runtime.Serialization (in System.Runtime.Serialization.dll)
  System.Runtime.Serialization.Xml (in System.Runtime.Serialization.Xml.dll)

public:
virtual bool IsStartObject(
	XmlDictionaryReader^ reader
) abstract

Parameters

reader
Type: System.Xml::XmlDictionaryReader

An XmlDictionaryReader used to read the XML stream or document.

Return Value

Type: System::Boolean
true if the reader can read the data; otherwise, false.

This method checks if the reader is positioned on an element to read, and returns true if the element is the top-level element for the object found in the XML stream or document. The XmlObjectSerializer implementation determines when to return true. Implementations may check that they are positioned on an element or look for an expected element name. One implementation of the XmlObjectSerializer, the DataContractSerializer, checks that it is positioned on an element and also checks that the element name is the top level expected name for the type currently being deserialized.

If needed, additional attributes in the XML stream can be read while positioned on the top level element before reading XML contents using the ReadObject method.

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft