XmlReader.ReadStartElement Método

Definição

Verifica se o nó atual é um elemento e avança o leitor para o próximo nó.Checks that the current node is an element and advances the reader to the next node.

Sobrecargas

ReadStartElement()

Verifica se o nó atual é um elemento e avança o leitor para o próximo nó.Checks that the current node is an element and advances the reader to the next node.

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ó.Checks that the current content node is an element with the given Name and advances the reader to the next node.

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ó.Checks that the current content node is an element with the given LocalName and NamespaceURI and advances the reader to the next node.

ReadStartElement()

Verifica se o nó atual é um elemento e avança o leitor para o próximo nó.Checks that the current node is an element and advances the reader to the next node.

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

Exceções

Foi encontrado um XML incorreto no fluxo de entrada.Incorrect XML was encountered in the input stream.

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentários

Esse método chama IsStartElement seguido pelo Read para posicioná-lo no conteúdo desse elemento encontrado no fluxo de entrada.This method calls IsStartElement followed by Read to position you on the content of that element found in the input stream.

Confira também

Aplica-se a

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ó.Checks that the current content node is an element with the given Name and advances the reader to the next node.

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.The qualified name of the element.

Exceções

Foi encontrado um XML incorreto no fluxo de entrada.Incorrect XML was encountered in the input stream.

- ou --or- O Name do elemento não corresponde ao name fornecido.The Name of the element does not match the given name.

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Exemplos

O exemplo a seguir exibe o conteúdo de texto de cada elemento.The following example displays the text content of each element.

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.The example uses the book3.xml file.

<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 .A call to this method corresponds to a call to IsStartElement followed by a call to Read.

Confira também

Aplica-se a

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ó.Checks that the current content node is an element with the given LocalName and NamespaceURI and advances the reader to the next node.

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.The local name of the element.

ns
String

O URI do namespace do elemento.The namespace URI of the element.

Exceções

Foi encontrado um XML incorreto no fluxo de entrada.Incorrect XML was encountered in the input stream.

- ou --or- As propriedades LocalName e NamespaceURI do elemento encontrado não correspondem aos argumentos fornecidos.The LocalName and NamespaceURI properties of the element found do not match the given arguments.

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentários

Uma chamada para esse método corresponde a uma chamada para IsStartElement seguida por uma chamada para Read .A call to this method corresponds to a call to IsStartElement followed by a call to Read.

Confira também

Aplica-se a