XmlReader.ReadToFollowing Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Lit jusqu'à trouver l'élément nommé.

Surcharges

ReadToFollowing(String)	Lit jusqu'à trouver un élément avec le nom qualifié spécifié.
ReadToFollowing(String, String)	Lit jusqu'à trouver un élément avec le nom local et l'URI de l'espace de noms spécifiés.

ReadToFollowing(String)

Lit jusqu'à trouver un élément avec le nom qualifié spécifié.

public:
 virtual bool ReadToFollowing(System::String ^ name);

public virtual bool ReadToFollowing (string name);

abstract member ReadToFollowing : string -> bool
override this.ReadToFollowing : string -> bool

Public Overridable Function ReadToFollowing (name As String) As Boolean

Paramètres

name

String

Nom qualifié de l'élément.

Retours

Boolean

true si un élément correspondant est trouvé ; sinon, false et XmlReader est dans un état de fin de fichier.

Exceptions

InvalidOperationException

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 ».

ArgumentException

Le paramètre est une chaîne vide.

Remarques

Cette méthode est fonctionnellement équivalente à l’exécution de l’expression following::name XPath à partir du nœud actuel. Il fournit un moyen rapide de trouver un élément nommé dans le document XML. Il avance le lecteur à l’élément suivant qui correspond au nom spécifié et retourne true si un élément correspondant est trouvé. À l’aide de l’exemple ci-dessous, le lecteur lit dans la première instance de l’élément spécifié lors de la lecture vers l’avant.

<!--"sample.xml"-->
<?xml version="1.0">
   <items>
      <item xmls="urn:1"/>
   </items>
</xml>

XmlTextReader reader = newXmlTextReader("sample.xml");

reader.ReadToFollowing("item");

Cette méthode peut être appelée sur tous les types de nœuds.

ReadToFollowing(String, String)

Lit jusqu'à trouver un élément avec le nom local et l'URI de l'espace de noms spécifiés.

public:
 virtual bool ReadToFollowing(System::String ^ localName, System::String ^ namespaceURI);

public virtual bool ReadToFollowing (string localName, string namespaceURI);

abstract member ReadToFollowing : string * string -> bool
override this.ReadToFollowing : string * string -> bool

Public Overridable Function ReadToFollowing (localName As String, namespaceURI As String) As Boolean

Paramètres

localName

String

Le nom local de l'élément.

namespaceURI

String

L'URI de l'espace de noms de l'élément.

Retours

Boolean

true si un élément correspondant est trouvé ; sinon, false et XmlReader est dans un état de fin de fichier.

Exceptions

InvalidOperationException

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 ».

ArgumentNullException

La valeur des deux paramètres est null.

Remarques

Cette méthode est fonctionnellement équivalente à l’exécution de l’expression following::name XPath à partir du nœud actuel. Il fournit un moyen rapide de trouver un élément nommé dans le document XML. Il avance le lecteur à l’élément suivant qui correspond au nom spécifié et retourne true si un élément correspondant est trouvé.

<!--"sample.xml"-->
<?xml version="1.0">
   <items>
      <item xmls="urn:1"/>
   </items>
</xml>

XmlTextReader reader = newXmlTextReader("sample.xml");

reader.ReadToFollowing("item", "urn:1");

Cette méthode peut être appelée sur tous les types de nœuds.