Поделиться через


XmlReader.ReadToDescendant Метод

Определение

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

Перегрузки

ReadToDescendant(String, String)

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

ReadToDescendant(String)

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

ReadToDescendant(String, String)

Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs

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

public:
 virtual bool ReadToDescendant(System::String ^ localName, System::String ^ namespaceURI);
public virtual bool ReadToDescendant (string localName, string namespaceURI);
abstract member ReadToDescendant : string * string -> bool
override this.ReadToDescendant : string * string -> bool
Public Overridable Function ReadToDescendant (localName As String, namespaceURI As String) As Boolean

Параметры

localName
String

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

namespaceURI
String

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

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

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

Если средство чтения XmlReader не размещено на элементе при вызове метода ReadToDescendant(String, String), последний возвращает значение false и положение XmlReader не изменяется.

Исключения

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

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

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

ReadToDescendant(String)

Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs

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

public:
 virtual bool ReadToDescendant(System::String ^ name);
public virtual bool ReadToDescendant (string name);
abstract member ReadToDescendant : string -> bool
override this.ReadToDescendant : string -> bool
Public Overridable Function ReadToDescendant (name As String) As Boolean

Параметры

name
String

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

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

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

Если средство чтения XmlReader не размещено на элементе при вызове метода ReadToDescendant(String), последний возвращает значение false и положение XmlReader не изменяется.

Исключения

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

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

Примеры

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

using (XmlReader reader = XmlReader.Create("2books.xml")) {

  // Move the reader to the second book node.
  reader.MoveToContent();
  reader.ReadToDescendant("book");
  reader.Skip(); //Skip the first book.

  // Parse the file starting with the second book node.
  do {
     switch (reader.NodeType) {
        case XmlNodeType.Element:
           Console.Write("<{0}", reader.Name);
           while (reader.MoveToNextAttribute()) {
               Console.Write(" {0}='{1}'", reader.Name, reader.Value);
           }
           Console.Write(">");
           break;
        case XmlNodeType.Text:
           Console.Write(reader.Value);
           break;
        case XmlNodeType.EndElement:
           Console.Write("</{0}>", reader.Name);
           break;
     }
  }  while (reader.Read());
}
Using reader As XmlReader = XmlReader.Create("2books.xml")

  ' Move the reader to the second book node.
  reader.MoveToContent()
  reader.ReadToDescendant("book")
  reader.Skip() 'Skip the first book.
  ' Parse the file starting with the second book node.
  Do
    Select Case reader.NodeType
      Case XmlNodeType.Element
        Console.Write("<{0}", reader.Name)
        While reader.MoveToNextAttribute()
            Console.Write(" {0}='{1}'", reader.Name, reader.Value)
        End While
        Console.Write(">")
      Case XmlNodeType.Text
        Console.Write(reader.Value)
      Case XmlNodeType.EndElement
        Console.Write("</{0}>", reader.Name)
    End Select
  Loop While reader.Read()

End Using

В этом примере в качестве входных данных используется файл 2books.xml.

<!--sample XML fragment-->
<bookstore>
  <book genre='novel' ISBN='10-861003-324'>
    <title>The Handmaid's Tale</title>
    <price>19.95</price>
  </book>
  <book genre='novel' ISBN='1-861001-57-5'>
    <title>Pride And Prejudice</title>
    <price>24.95</price>
  </book>
</bookstore>

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