XmlReader::ReadElementString Method (String^, String^)
Checks that the LocalName and NamespaceURI properties of the element found matches the given strings before reading a text-only element. However, we recommend that you use the ReadElementContentAsString(String^, String^) method instead, because it provides a more straightforward way to handle this operation.
Assembly: System.Xml (in System.Xml.dll)
Parameters
- localname
-
Type:
System::String^
The local name to check.
- ns
-
Type:
System::String^
The namespace URI to check.
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 | If the next content node is not a start tag; if the element LocalName or NamespaceURI do not match the given arguments; 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(String^, String^) method to read a text element.
Available since 1.1