XmlReader.ReadToFollowing Метод

Определение

Пространство имен:

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

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

Перегрузки

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 в конец файла.

Исключения

InvalidOperationException

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

ArgumentException

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

Комментарии

Этот метод функционально эквивалентен выполнению 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 в конец файла.

Исключения

InvalidOperationException

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

ArgumentNullException

Оба параметра имеют значение 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");

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