XmlReader.ReadStartElement XmlReader.ReadStartElement XmlReader.ReadStartElement XmlReader.ReadStartElement Method

Definición

Comprueba si el nodo actual es un elemento y desplaza el lector hasta el siguiente nodo.Checks that the current node is an element and advances the reader to the next node.

Sobrecargas

ReadStartElement() ReadStartElement() ReadStartElement() ReadStartElement()

Comprueba si el nodo actual es un elemento y desplaza el lector hasta el siguiente nodo.Checks that the current node is an element and advances the reader to the next node.

ReadStartElement(String) ReadStartElement(String) ReadStartElement(String) ReadStartElement(String)

Comprueba si el nodo de contenido actual es un elemento con la propiedad Name especificada y desplaza el lector hasta el siguiente nodo.Checks that the current content node is an element with the given Name and advances the reader to the next node.

ReadStartElement(String, String) ReadStartElement(String, String) ReadStartElement(String, String) ReadStartElement(String, String)

Comprueba si el nodo de contenido actual es un elemento con las propiedades LocalName y NamespaceURI especificadas y desplaza el lector hasta el siguiente nodo.Checks that the current content node is an element with the given LocalName and NamespaceURI and advances the reader to the next node.

ReadStartElement() ReadStartElement() ReadStartElement() ReadStartElement()

Comprueba si el nodo actual es un elemento y desplaza el lector hasta el siguiente nodo.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 ()

Excepciones

Se detectó XML incorrecto en el flujo de entrada.Incorrect XML was encountered in the input stream.

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentarios

Este método llama IsStartElement Read a seguido de para colocarlo en el contenido de ese elemento que se encuentra en el flujo de entrada.This method calls IsStartElement followed by Read to position you on the content of that element found in the input stream.

Consulte también:

ReadStartElement(String) ReadStartElement(String) ReadStartElement(String) ReadStartElement(String)

Comprueba si el nodo de contenido actual es un elemento con la propiedad Name especificada y desplaza el lector hasta el siguiente nodo.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 String String String

Nombre completo del elemento.The qualified name of the element.

Excepciones

Se detectó XML incorrecto en el flujo de entrada.Incorrect XML was encountered in the input stream.

o bien-or- El objeto Name del elemento no coincide con el name especificado.The Name of the element does not match the given name.

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Ejemplos

En el ejemplo siguiente se muestra el contenido 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

En el ejemplo se book3.xml usa el archivo.The example uses the book3.xml file.

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

Comentarios

Una llamada a este método corresponde a una llamada a IsStartElement seguida por una llamada a Read.A call to this method corresponds to a call to IsStartElement followed by a call to Read.

Consulte también:

ReadStartElement(String, String) ReadStartElement(String, String) ReadStartElement(String, String) ReadStartElement(String, String)

Comprueba si el nodo de contenido actual es un elemento con las propiedades LocalName y NamespaceURI especificadas y desplaza el lector hasta el siguiente nodo.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 String String String

Nombre local del elemento.The local name of the element.

ns
String String String String

Identificador URI de espacio de nombres del elemento.The namespace URI of the element.

Excepciones

Se detectó XML incorrecto en el flujo de entrada.Incorrect XML was encountered in the input stream.

O bien-or- Las propiedades LocalName y NamespaceURI del elemento encontrado no coinciden con los argumentos especificados.The LocalName and NamespaceURI properties of the element found do not match the given arguments.

Se llamó un método XmlReader antes de que se termine una operación asincrónica anterior.An XmlReader method was called before a previous asynchronous operation finished. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentarios

Una llamada a este método corresponde a una llamada a IsStartElement seguida por una llamada a Read.A call to this method corresponds to a call to IsStartElement followed by a call to Read.

Consulte también:

Se aplica a