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.

public:
 virtual bool IsStartElement(System::String ^ localname, System::String ^ ns);

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

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

Public Overridable Function IsStartElement (localname As String, ns As String) As Boolean

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.

public:
 virtual bool IsStartElement();

public virtual bool IsStartElement ();

abstract member IsStartElement : unit -> bool
override this.IsStartElement : unit -> bool

Public Overridable Function IsStartElement () As Boolean

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.

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

While reader.Read()
  If reader.IsStartElement() Then
    If reader.IsEmptyElement Then
      Console.WriteLine("<{0}/>", reader.Name)
    Else
      Console.Write("<{0}> ", reader.Name)
      reader.Read() ' Read the start tag.
      If reader.IsStartElement() Then ' Handle nested elements.
        Console.Write(vbCr + vbLf + "<{0}>", reader.Name)
      End If
      Console.WriteLine(reader.ReadString()) 'Read the text content of the element.
    End If
  End If
End While

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

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

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

public virtual bool IsStartElement (string name);

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

Public Overridable Function IsStartElement (name As String) As Boolean

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.

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

' Parse the file and display each price node.
While reader.Read()
  If reader.IsStartElement("price") Then
    Console.WriteLine(reader.ReadInnerXml())
  End If
End While

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()