Бөлісу құралы:


XmlReader.Skip Метод

Определение

Пропускает дочерний узел текущего узла.

public:
 virtual void Skip();
public virtual void Skip ();
abstract member Skip : unit -> unit
override this.Skip : unit -> unit
Public Overridable Sub Skip ()

Исключения

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

Примеры

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

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>

Комментарии

Если средство чтения размещено на <a> узле или любом из его атрибутов, вызов средства Skip чтения помещает средство чтения в <b> узел.

Если средство чтения размещено на конечном узле (например, на узле или текстовом узле), вызов Skip будет таким же, как <x> и при вызовеRead.abc

<a name="bob" age="123">
 <x/>abc<y/>
</a>
<b>
...
</b>

Этот метод проверяет наличие xml-кода правильного формата.

Если средство чтения является средством XmlValidatingReaderчтения, этот метод также проверяет пропущенное содержимое.

Реализация XmlReader определяет, будет ли Skip метод расширять внешние сущности. В следующей таблице описывается, расширяются ли внешние сущности для различных типов XmlReader объектов.

Тип XmlReader Разворачивает внешние сущности
XmlTextReader Нет.
XmlReader экземпляр, созданный методом Create , который считывает текстовые данные. Нет.
XmlReader экземпляр, созданный методом Create , который считывает двоичные данные. Неприменимо.
Схема, проверяющая XmlReader экземпляр, созданный методом Create . Да.
XmlValidatingReader Да.
XmlReader экземпляр, возвращаемый XPathNavigator объектом. Неприменимо.
XmlNodeReader Нет.
XmlReader экземпляр, завернутый вокруг другого XmlReader экземпляра. Зависит от реализации базового XmlReader. (Вызывается Skip метод в базовом XmlReader объекте).

Асинхронная версия этого метода см. в разделе SkipAsync.

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