XmlReader.ReadStartElement Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Проверяет, является ли текущий узел элементом и перемещает читателя к следующему узлу.

Перегрузки

Имя	Описание
ReadStartElement()	Проверяет, является ли текущий узел элементом и перемещает читателя к следующему узлу.
ReadStartElement(String)	Проверяет, является ли текущий узел содержимого элементом с заданным Name и перемещает читателя к следующему узлу.
ReadStartElement(String, String)	Проверяет, является ли текущий узел содержимого элементом с заданным LocalName и NamespaceURI перемещает читателя к следующему узлу.

ReadStartElement()

Исходный код:

XmlReader.cs

Проверяет, является ли текущий узел элементом и перемещает читателя к следующему узлу.

public:
 virtual void ReadStartElement();

public virtual void ReadStartElement();

abstract member ReadStartElement : unit -> unit
override this.ReadStartElement : unit -> unit

Public Overridable Sub ReadStartElement ()

Исключения

XmlException

В входном потоке обнаружен неправильный XML-код.

InvalidOperationException

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

Комментарии

Этот метод вызывает IsStartElement вызовы Read , за которыми следует разместить содержимое этого элемента, найденного в входном потоке.

См. также раздел

• ReadEndElement()

ReadStartElement(String)

Исходный код:

XmlReader.cs

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

public:
 virtual void ReadStartElement(System::String ^ name);

public virtual void ReadStartElement(string name);

abstract member ReadStartElement : string -> unit
override this.ReadStartElement : string -> unit

Public Overridable Sub ReadStartElement (name As String)

Параметры

name

String

Полное имя элемента.

Исключения

XmlException

В входном потоке обнаружен неправильный XML-код.

–или–

Элемент Name не соответствует заданному name.

InvalidOperationException

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

Примеры

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

using (XmlReader reader = XmlReader.Create("book3.xml")) {

  // Parse the XML document.  ReadString is used to
  // read the text content of the elements.
  reader.Read();
  reader.ReadStartElement("book");
  reader.ReadStartElement("title");
  Console.Write("The content of the title element:  ");
  Console.WriteLine(reader.ReadString());
  reader.ReadEndElement();
  reader.ReadStartElement("price");
  Console.Write("The content of the price element:  ");
  Console.WriteLine(reader.ReadString());
  reader.ReadEndElement();
  reader.ReadEndElement();
}

Using reader As XmlReader = XmlReader.Create("book3.xml")
  ' Parse the XML document.  ReadString is used to
  ' read the text content of the elements.
  reader.Read()
  reader.ReadStartElement("book")
  reader.ReadStartElement("title")
  Console.Write("The content of the title element:  ")
  Console.WriteLine(reader.ReadString())
  reader.ReadEndElement()
  reader.ReadStartElement("price")
  Console.Write("The content of the price element:  ")
  Console.WriteLine(reader.ReadString())
  reader.ReadEndElement()
  reader.ReadEndElement()
End Using

В примере используется book3.xml файл.

<book>
  <title>Pride And Prejudice</title>
  <price>19.95</price>
</book>

Комментарии

Вызов этого метода соответствует вызову, за IsStartElement которым следует вызов Read.

См. также раздел

• ReadEndElement()

ReadStartElement(String, String)

Исходный код:

XmlReader.cs

Проверяет, является ли текущий узел содержимого элементом с заданным LocalName и NamespaceURI перемещает читателя к следующему узлу.

public:
 virtual void ReadStartElement(System::String ^ localname, System::String ^ ns);

public virtual void ReadStartElement(string localname, string ns);

abstract member ReadStartElement : string * string -> unit
override this.ReadStartElement : string * string -> unit

Public Overridable Sub ReadStartElement (localname As String, ns As String)

Параметры

localname

String

Локальное имя элемента.

ns

String

URI пространства имен элемента.

Исключения

XmlException

В входном потоке обнаружен неправильный XML-код.

–или–

LocalName Найденные NamespaceURI свойства элемента не соответствуют заданным аргументам.

InvalidOperationException

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

Комментарии

Вызов этого метода соответствует вызову, за IsStartElement которым следует вызов Read.

См. также раздел

• ReadEndElement()