XmlReader.ReadToNextSibling Метод

Определение

Переводит XmlReader к следующему сопоставленному родственному элементу.Advances the XmlReader to the next matching sibling element.

Перегрузки

ReadToNextSibling(String)

Переводит XmlReader к следующему сопоставленному родственному элементу с указанным проверенным именем.Advances the XmlReader to the next sibling element with the specified qualified name.

ReadToNextSibling(String, String)

Переводит XmlReader к следующему элементу того же уровня с указанным локальным именем и URI пространства имен.Advances the XmlReader to the next sibling element with the specified local name and namespace URI.

ReadToNextSibling(String)

Переводит XmlReader к следующему сопоставленному родственному элементу с указанным проверенным именем.Advances the XmlReader to the next sibling element with the specified qualified name.

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

Полное имя элемента того же уровня, на который следует переместиться.The qualified name of the sibling element you wish to move to.

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

true, если найден сопоставленный родственный элемент; в противном случае — false.true if a matching sibling element is found; otherwise false. Если такой элемент не найден, средство чтения XmlReader позиционируется на закрывающем теге (NodeType является XmlNodeType.EndElement) родительского элемента.If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

Исключения

Метод XmlReader вызван перед завершением предыдущей асинхронной операции.An XmlReader method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Параметр является пустой строкой.The parameter is an empty string.

Примеры

В следующем примере считывается атрибут ISBN для каждого узла книги.The following example reads the ISBN attribute on each book node.

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 Initial).Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). Можно вызвать Read, чтобы переместить XmlReader, а затем вызвать метод ReadToNextSibling.You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

ReadToNextSibling(String, String)

Переводит XmlReader к следующему элементу того же уровня с указанным локальным именем и URI пространства имен.Advances the XmlReader to the next sibling element with the specified local name and namespace 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

Локальное имя элемента того же уровня, на который следует переместиться.The local name of the sibling element you wish to move to.

namespaceURI
String

Универсальный код ресурса (URI) пространства имен элемента того же уровня, на который следует переместиться.The namespace URI of the sibling element you wish to move to.

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

Значение true, если найден сопоставленный элемент с тем же родительским элементом. В противном случае — значение false.true if a matching sibling element is found; otherwise, false. Если такой элемент не найден, средство чтения XmlReader позиционируется на закрывающем теге (NodeType является XmlNodeType.EndElement) родительского элемента.If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

Исключения

Метод XmlReader вызван перед завершением предыдущей асинхронной операции.An XmlReader method was called before a previous asynchronous operation finished. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Оба параметра имеют значение null.Both parameter values are null.

Комментарии

Примечание

Не вызывайте ReadToNextSibling, если XmlReader является начальным состоянием (ReadState Initial).Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). Можно вызвать Read, чтобы переместить XmlReader, а затем вызвать метод ReadToNextSibling.You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

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