XmlReader.IsStartElement Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Vérifie si le nœud de contenu est une balise de début.

Surcharges

IsStartElement(String, String)	Appelle MoveToContent(), vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide, puis vérifie également si les propriétés LocalName et NamespaceURI de l'élément trouvé correspondent aux chaînes spécifiées.
IsStartElement()	Appelle MoveToContent() et vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide.
IsStartElement(String)	Appelle MoveToContent(), vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide, puis vérifie également si la propriété Name de l'élément trouvé correspond à l'argument spécifié.

IsStartElement(String, String)

Source:

XmlReader.cs

Appelle MoveToContent(), vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide, puis vérifie également si les propriétés LocalName et NamespaceURI de l'élément trouvé correspondent aux chaînes spécifiées.

C#

public virtual bool IsStartElement (string localname, string ns);

Paramètres

localname

String

Chaîne à comparer à la propriété LocalName de l'élément trouvé.

ns

String

Chaîne à comparer à la propriété NamespaceURI de l'élément trouvé.

Retours

Boolean

true si le nœud résultant est un élément. false si un type de nœud autre que XmlNodeType.Element a été trouvé ou si les propriétés LocalName et NamespaceURI de l'élément ne correspondent pas aux chaînes spécifiées.

Exceptions

XmlException

Code XML incorrect dans le flux d'entrée.

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

Remarques

Cette méthode ignore les espaces blancs, les commentaires et les instructions de traitement jusqu’à ce que le lecteur soit positionné sur un nœud de contenu. La méthode teste ensuite si le nœud actuel est un élément.

Voir aussi

• MoveToContent()

IsStartElement()

Source:

XmlReader.cs

Appelle MoveToContent() et vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide.

C#

public virtual bool IsStartElement ();

Retours

Boolean

true si MoveToContent() trouve une balise de début ou une balise d'élément vide ; false si un type de nœud autre que XmlNodeType.Element est trouvé.

Exceptions

XmlException

Code XML incorrect dans le flux d'entrée.

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

Exemples

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

C#

while (reader.Read()) {
  if (reader.IsStartElement()) {
    if (reader.IsEmptyElement)
                {
                    Console.WriteLine("<{0}/>", reader.Name);
                }
                else {
      Console.Write("<{0}> ", reader.Name);
      reader.Read(); // Read the start tag.
      if (reader.IsStartElement())  // Handle nested elements.
        Console.Write("\r\n<{0}>", reader.Name);
      Console.WriteLine(reader.ReadString());  //Read the text content of the element.
    }
  }
}

L’exemple utilise le fichier , elems.xmlcomme entrée.

XML

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

Remarques

Cette méthode ignore les espaces blancs, les commentaires et les instructions de traitement jusqu’à ce que le lecteur soit positionné sur un nœud de contenu. La méthode teste ensuite si le nœud actuel est un élément.

Voir aussi

• MoveToContent()

IsStartElement(String)

Source:

XmlReader.cs

Appelle MoveToContent(), vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide, puis vérifie également si la propriété Name de l'élément trouvé correspond à l'argument spécifié.

C#

public virtual bool IsStartElement (string name);

Paramètres

name

String

Chaîne comparée à la propriété Name de l'élément trouvé.

Retours

Boolean

true si le nœud résultant est un élément et si la propriété Name correspond à la chaîne spécifiée. false si un type de nœud autre que XmlNodeType.Element a été trouvé ou si la propriété Name de l'élément ne correspond pas à la chaîne spécifiée.

Exceptions

XmlException

Code XML incorrect dans le flux d'entrée.

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

Exemples

L’exemple suivant affiche chaque élément price.

C#

// Parse the file and display each price node.
while (reader.Read()) {
  if (reader.IsStartElement("price")) {
     Console.WriteLine(reader.ReadInnerXml());
  }
}

Remarques

Cette méthode ignore les espaces blancs, les commentaires et les instructions de traitement jusqu’à ce que le lecteur soit positionné sur un nœud de contenu. La méthode teste ensuite si le nœud actuel est un élément.

Voir aussi

• MoveToContent()