XmlReader.ReadToNextSibling Метод

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

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

Перегрузки

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

ReadToNextSibling(String)

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

public:
 virtual bool ReadToNextSibling(System::String ^ name);

public virtual bool ReadToNextSibling (string name);

abstract member ReadToNextSibling : string -> bool
override this.ReadToNextSibling : string -> bool

Public Overridable Function ReadToNextSibling (name As String) As Boolean

Параметры

name

String

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

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

Boolean

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

Исключения

InvalidOperationException

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

ArgumentException

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

Примеры

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

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

Using reader As XmlReader = XmlReader.Create("books.xml")
  reader.ReadToFollowing("book")
  Do
    Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"))
  Loop While reader.ReadToNextSibling("book")
End Using

Комментарии

Примечание

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

ReadToNextSibling(String, String)

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

public:
 virtual bool ReadToNextSibling(System::String ^ localName, System::String ^ namespaceURI);

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

abstract member ReadToNextSibling : string * string -> bool
override this.ReadToNextSibling : string * string -> bool

Public Overridable Function ReadToNextSibling (localName As String, namespaceURI As String) As Boolean

Параметры

localName

String

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

namespaceURI

String

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

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

Boolean

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

Исключения

InvalidOperationException

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

ArgumentNullException

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

Комментарии

Примечание

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