XmlReader.ReadToNextSibling Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Переводит XmlReader
к следующему сопоставленному родственному элементу.
ReadToNextSibling(String) |
Переводит |
ReadToNextSibling(String, String) |
Переводит |
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
Полное имя элемента того же уровня, на который следует переместиться.
Возвращаемое значение
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"));
}
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) пространства имен элемента того же уровня, на который следует переместиться.
Возвращаемое значение
Значение true
, если найден сопоставленный элемент с тем же родительским элементом. В противном случае — значение false
. Если такой элемент не найден, средство чтения XmlReader
позиционируется на закрывающем теге (NodeType является XmlNodeType.EndElement
) родительского элемента.
Исключения
Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".
Оба параметра имеют значение null
.
Комментарии
Ескерім
Не вызывайте ReadToNextSibling , если XmlReader
это начальное состояние (ReadState is Initial). Вы можете вызвать Read метод для продвижения XmlReader
и вызова ReadToNextSibling метода.