XmlReader.ReadStartElement Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

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

Sobrecargas

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 Name fornecido e avança o leitor para o próximo nó.
ReadStartElement(String, String)	Verifica se o nó de conteúdo atual é um elemento com o LocalName e NamespaceURI fornecidos e avança o leitor para o próximo nó.

ReadStartElement()

Origem:

XmlReader.cs

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 um XML incorreto no fluxo de entrada.

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Comentários

Esse método chama IsStartElement seguido por Read para posicioná-lo sobre o conteúdo desse elemento encontrado no fluxo de entrada.

Confira também

• ReadEndElement()

ReadStartElement(String)

Origem:

XmlReader.cs

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

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 um XML incorreto no fluxo de entrada.

- ou -

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

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Exemplos

O exemplo a seguir exibe o conteúdo de texto 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 usa o book3.xml arquivo .

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

Comentários

Uma chamada para esse método corresponde a uma chamada para IsStartElement seguida por uma chamada para Read.

Confira também

• ReadEndElement()

ReadStartElement(String, String)

Origem:

XmlReader.cs

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

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 um XML incorreto no fluxo de entrada.

- ou -

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

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Comentários

Uma chamada para esse método corresponde a uma chamada para IsStartElement seguida por uma chamada para Read.

Confira também

• ReadEndElement()