XmlReader.ReadToNextSibling Метод

Определение

Переводит XmlReader к следующему сопоставленному родственному элементу.

Перегрузки

ReadToNextSibling(String)

Переводит XmlReader к следующему сопоставленному родственному элементу с указанным проверенным именем.

ReadToNextSibling(String, String)

Переводит XmlReader к следующему элементу того же уровня с указанным локальным именем и URI пространства имен.

ReadToNextSibling(String)

Переводит XmlReader к следующему сопоставленному родственному элементу с указанным проверенным именем.

public virtual bool ReadToNextSibling (string name);

Параметры

name
String

Полное имя элемента того же уровня, на который следует переместиться.

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

Boolean

true, если найден сопоставленный родственный элемент; в противном случае — false. Если такой элемент не найден, средство чтения XmlReader позиционируется на закрывающем теге (NodeType является XmlNodeType.EndElement) родительского элемента.

Исключения

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

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

Примеры

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

using (XmlReader reader = XmlReader.Create("books.xml")) {
    reader.ReadToFollowing("book");
    do {
       Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"));
    } while (reader.ReadToNextSibling("book"));
}

Комментарии

Ескерім

Не вызывайте ReadToNextSibling , если XmlReader это начальное состояние (ReadState is Initial). Вы можете вызвать Read метод для продвижения XmlReader и вызова ReadToNextSibling метода.

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

ReadToNextSibling(String, String)

Переводит XmlReader к следующему элементу того же уровня с указанным локальным именем и URI пространства имен.

public virtual bool ReadToNextSibling (string localName, string namespaceURI);

Параметры

localName
String

Локальное имя элемента того же уровня, на который следует переместиться.

namespaceURI
String

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

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

Boolean

Значение true, если найден сопоставленный элемент с тем же родительским элементом. В противном случае — значение false. Если такой элемент не найден, средство чтения XmlReader позиционируется на закрывающем теге (NodeType является XmlNodeType.EndElement) родительского элемента.

Исключения

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

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

Комментарии

Ескерім

Не вызывайте ReadToNextSibling , если XmlReader это начальное состояние (ReadState is Initial). Вы можете вызвать Read метод для продвижения XmlReader и вызова ReadToNextSibling метода.

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