XmlReader.ReadStartElement Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
netstandard.dll

Verifica se o nó atual é um elemento e avança o leitor para o próximo nó.

Sobrecargas

Name Description
ReadStartElement()

Verifica se o nó atual é um elemento e avança o leitor para o próximo nó.
ReadStartElement(String)

Verifica se o nó de conteúdo atual é um elemento com o dado Name e avança o leitor para o nó seguinte.
ReadStartElement(String, String)

Verifica se o nó de conteúdo atual é um elemento com o dado LocalName e NamespaceURI avança o leitor para o nó seguinte.

ReadStartElement()

Verifica se o nó atual é um elemento e avança o leitor para o próximo nó.

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

Exceções

XmlException

Foi encontrado XML incorreto no fluxo de entrada.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Observações

Este método chama IsStartElement seguido de Read para te posicionar sobre o conteúdo desse elemento encontrado no fluxo de entrada.

Ver também

Aplica-se a

ReadStartElement(String)

Verifica se o nó de conteúdo atual é um elemento com o dado Name e avança o leitor para o nó seguinte.

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)

Parâmetros

name
String

O nome qualificado do elemento.

Exceções

XmlException

Foi encontrado XML incorreto no fluxo de entrada.

-ou-

O Name do elemento não corresponde ao dado name.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Exemplos

O exemplo seguinte mostra o conteúdo textual de cada elemento.

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

O exemplo utiliza o book3.xml ficheiro.

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

Observações

Uma chamada a este método corresponde a uma chamada para IsStartElement seguida de uma chamada para Read.

Ver também

Aplica-se a

ReadStartElement(String, String)

Verifica se o nó de conteúdo atual é um elemento com o dado LocalName e NamespaceURI avança o leitor para o nó seguinte.

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)

Parâmetros

localname
String

O nome local do elemento.

ns
String

O URI do namespace do elemento.

Exceções

XmlException

Foi encontrado XML incorreto no fluxo de entrada.

-ou-

As LocalName propriedades e NamespaceURI do elemento encontrado não correspondem aos argumentos dados.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Observações

Uma chamada a este método corresponde a uma chamada para IsStartElement seguida de uma chamada para Read.

Ver também

Aplica-se a