XmlReader::ReadToFollowing Method (String^)
Reads until an element with the specified qualified name is found.
Assembly: System.Xml (in System.Xml.dll)
Parameters
- name
-
Type:
System::String^
The qualified name of the element.
Return Value
Type: System::Booleantrue if a matching element is found; otherwise false and the XmlReader is in an end of file state.
| Exception | Condition |
|---|---|
| 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.” |
| ArgumentException | The parameter is an empty string. |
This method is functionally equivalent executing the following::name XPath expression from the current node. It provides a quick way to find a named element in the XML document. It advances the reader to the next following element that matches the specified name and returns true if a matching element is found. Using the example below, the reader would read to the first instance of the specified element while reading forward.
<!--"sample.xml"--> <?xmlversion="1.0"> <items> <item xmls="urn:1"/> </items> </xml>
XmlTextReader reader = newXmlTextReader("sample.xml"); reader.ReadToFollowing("item");
This method can be called on all node types.
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1