XmlReader.ReadElementString Method (String)

Checks that the Name property of the element found matches the given string before reading a text-only element. However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

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

public virtual string ReadElementString(
	string name
)

Parameters

name
Type: System.String

The name to check.

Return Value

Type: System.String
The text contained in the element that was read. An empty string if the element is empty.

ExceptionCondition
XmlException

If the next content node is not a start tag; if the element Name does not match the given argument; or if the element found does not contain a simple text value.

InvalidOperationException

An XmlReader method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message “An asynchronous operation is already in progress.”

We recommend that you use the ReadElementContentAsString() method to read a text element.

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft