XmlReader.ReadToNextSibling Méthode

Définition

Avance XmlReader jusqu'au prochain élément frère correspondant.

Surcharges

ReadToNextSibling(String)

Avance le XmlReader vers l'élément frère suivant portant le nom qualifié spécifié.

ReadToNextSibling(String, String)

Avance XmlReader vers l’élément frère suivant doté du nom local et de l’URI de l’espace de noms spécifiés.

ReadToNextSibling(String)

Avance le XmlReader vers l'élément frère suivant portant le nom qualifié spécifié.

public:
 virtual bool ReadToNextSibling(System::String ^ name);
public virtual bool ReadToNextSibling (string name);
abstract member ReadToNextSibling : string -> bool
override this.ReadToNextSibling : string -> bool
Public Overridable Function ReadToNextSibling (name As String) As Boolean

Paramètres

name
String

Nom qualifié de l'élément frère vers lequel se déplacer.

Retours

Boolean

true si un élément frère correspondant est trouvé ; sinon, false. Si aucun élément frère correspondant n’est trouvé, le XmlReader est placé sur la balise de fin (NodeType est XmlNodeType.EndElement) de l’élément parent.

Exceptions

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

Le paramètre est une chaîne vide.

Exemples

L’exemple suivant lit l’attribut ISBN sur chaque nœud de livre.

using (XmlReader reader = XmlReader.Create("books.xml")) {
    reader.ReadToFollowing("book");
    do {
       Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"));
    } while (reader.ReadToNextSibling("book"));
}
Using reader As XmlReader = XmlReader.Create("books.xml")
  reader.ReadToFollowing("book")
  Do
    Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"))
  Loop While reader.ReadToNextSibling("book")
End Using

Remarques

Notes

N’appelez pas ReadToNextSibling lorsque XmlReader est un état initial ( ReadState est Initial ). Vous pouvez appeler Read pour avancer XmlReader , puis appeler la ReadToNextSibling méthode.

S’applique à

ReadToNextSibling(String, String)

Avance XmlReader vers l’élément frère suivant doté du nom local et de l’URI de l’espace de noms spécifiés.

public:
 virtual bool ReadToNextSibling(System::String ^ localName, System::String ^ namespaceURI);
public virtual bool ReadToNextSibling (string localName, string namespaceURI);
abstract member ReadToNextSibling : string * string -> bool
override this.ReadToNextSibling : string * string -> bool
Public Overridable Function ReadToNextSibling (localName As String, namespaceURI As String) As Boolean

Paramètres

localName
String

Nom local de l'élément frère vers lequel se déplacer.

namespaceURI
String

URI de l'espace de noms de l'élément frère vers lequel se déplacer.

Retours

Boolean

true si un élément frère correspondant est trouvé ; sinon, false. Si aucun élément frère correspondant n’est trouvé, le XmlReader est placé sur la balise de fin (NodeType est XmlNodeType.EndElement) de l’élément parent.

Exceptions

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

La valeur des deux paramètres est null.

Remarques

Notes

N’appelez pas ReadToNextSibling lorsque XmlReader est un état initial ( ReadState est Initial ). Vous pouvez appeler Read pour avancer XmlReader , puis appeler la ReadToNextSibling méthode.

S’applique à