XmlReader.ReadStartElement Метод

Определение

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

System.Xml

Сборка:

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()