XmlReader::ReadElementString Method ()

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Reads 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()

Return Value

Type: System::String^

The text contained in the element that was read. An empty string if the element is empty.

Exception Condition
XmlException

The next content node is not a start tag; or 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
Available since 1.1
Return to top
Show: