XmlReader.ReadStartElement Méthode

Définition

Espace de noms:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
netstandard.dll

Vérifie que le nœud actuel est un élément et avance le lecteur vers le nœud suivant.

Surcharges

Nom Description
ReadStartElement()

Vérifie que le nœud actuel est un élément et avance le lecteur vers le nœud suivant.
ReadStartElement(String)

Vérifie que le nœud de contenu actuel est un élément avec le lecteur donné Name et avance le lecteur vers le nœud suivant.
ReadStartElement(String, String)

Vérifie que le nœud de contenu actuel est un élément avec l’élément donné LocalName et NamespaceURI avance le lecteur vers le nœud suivant.

ReadStartElement()

Vérifie que le nœud actuel est un élément et avance le lecteur vers le nœud suivant.

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

Exceptions

XmlException

Le code XML incorrect a été rencontré dans le flux d’entrée.

InvalidOperationException

Une XmlReader méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Cette méthode appelle IsStartElement ensuite Read pour vous positionner sur le contenu de cet élément trouvé dans le flux d’entrée.

Voir aussi

S’applique à

ReadStartElement(String)

Vérifie que le nœud de contenu actuel est un élément avec le lecteur donné Name et avance le lecteur vers le nœud suivant.

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)

Paramètres

name
String

Nom qualifié de l’élément.

Exceptions

XmlException

Le code XML incorrect a été rencontré dans le flux d’entrée.

-ou-

L’élément Name ne correspond pas à l’élément donné name.

InvalidOperationException

Une XmlReader méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Exemples

L’exemple suivant affiche le contenu texte de chaque élément.

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

L’exemple utilise le book3.xml fichier.

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

Remarques

Un appel à cette méthode correspond à un appel à IsStartElement suivi d’un appel à Read.

Voir aussi

S’applique à

ReadStartElement(String, String)

Vérifie que le nœud de contenu actuel est un élément avec l’élément donné LocalName et NamespaceURI avance le lecteur vers le nœud suivant.

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)

Paramètres

localname
String

Nom local de l’élément.

ns
String

URI d’espace de noms de l’élément.

Exceptions

XmlException

Le code XML incorrect a été rencontré dans le flux d’entrée.

-ou-

Les LocalName propriétés de NamespaceURI l’élément trouvé ne correspondent pas aux arguments donnés.

InvalidOperationException

Une XmlReader méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

Un appel à cette méthode correspond à un appel à IsStartElement suivi d’un appel à Read.

Voir aussi

S’applique à