XmlReader.ReadToFollowing Метод

Определение

Выполняет чтение до обнаружения именованного элемента.

Перегрузки

ReadToFollowing(String)

Выполняет чтение до обнаружения элемента с указанным полным именем.

ReadToFollowing(String, String)

Выполняет чтение до обнаружения указанных локального имени и URI пространства имен.

ReadToFollowing(String)

Выполняет чтение до обнаружения элемента с указанным полным именем.

public:
 virtual bool ReadToFollowing(System::String ^ name);
public virtual bool ReadToFollowing (string name);
abstract member ReadToFollowing : string -> bool
override this.ReadToFollowing : string -> bool
Public Overridable Function ReadToFollowing (name As String) As Boolean

Параметры

name
String

Полное имя элемента.

Возвращаемое значение

Boolean

Значение true, если найден соответствующий элемент; в противном случае —false и перемещение XmlReader в конец файла.

Исключения

Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

Параметр является пустой строкой.

Комментарии

Этот метод функционально эквивалентен выполнению following::name выражения XPath из текущего узла. Он обеспечивает быстрый способ поиска именованного элемента в XML-документе. Он перемещает средство чтения к следующему следующему элементу, который соответствует заданному имени, и возвращает, true если найден соответствующий элемент. Используя приведенный ниже пример, читатель считывает данные в первый экземпляр указанного элемента при чтении вперед.

<!--"sample.xml"-->  
<?xml version="1.0">  
   <items>  
      <item xmls="urn:1"/>  
   </items>  
</xml>  
XmlTextReader reader = newXmlTextReader("sample.xml");  

reader.ReadToFollowing("item");  

Этот метод может быть вызван для всех типов узлов.

Применяется к

ReadToFollowing(String, String)

Выполняет чтение до обнаружения указанных локального имени и URI пространства имен.

public:
 virtual bool ReadToFollowing(System::String ^ localName, System::String ^ namespaceURI);
public virtual bool ReadToFollowing (string localName, string namespaceURI);
abstract member ReadToFollowing : string * string -> bool
override this.ReadToFollowing : string * string -> bool
Public Overridable Function ReadToFollowing (localName As String, namespaceURI As String) As Boolean

Параметры

localName
String

Локальное имя элемента.

namespaceURI
String

Универсальный код ресурса (URI) пространства имен элемента.

Возвращаемое значение

Boolean

Значение true, если найден соответствующий элемент; в противном случае —false и перемещение XmlReader в конец файла.

Исключения

Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

Оба параметра имеют значение null.

Комментарии

Этот метод функционально эквивалентен выполнению following::name выражения XPath из текущего узла. Он обеспечивает быстрый способ поиска именованного элемента в XML-документе. Он перемещает средство чтения к следующему следующему элементу, который соответствует заданному имени, и возвращает, true если найден соответствующий элемент.

<!--"sample.xml"-->  
<?xml version="1.0">  
   <items>  
      <item xmls="urn:1"/>  
   </items>  
</xml>  
XmlTextReader reader = newXmlTextReader("sample.xml");  

reader.ReadToFollowing("item", "urn:1");  

Этот метод может быть вызван для всех типов узлов.

Применяется к