XmlReader.IsStartElement Méthode

Définition

Espace de noms:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Teste si le nœud de contenu actuel est une balise de début.

Surcharges

Nom	Description
IsStartElement(String, String)	Appelle MoveToContent() et teste si le nœud de contenu actuel est une balise de début ou une balise d’élément vide et si les LocalName propriétés de NamespaceURI l’élément trouvé correspondent aux chaînes données.
IsStartElement()	Appelle MoveToContent() et teste si le nœud de contenu actuel est une balise de démarrage ou une balise d’élément vide.
IsStartElement(String)	Appelle MoveToContent() et teste si le nœud de contenu actuel est une balise de début ou une balise d’élément vide et si la Name propriété de l’élément trouvé correspond à l’argument donné.

IsStartElement(String, String)

Source:

XmlReader.cs

Appelle MoveToContent() et teste si le nœud de contenu actuel est une balise de début ou une balise d’élément vide et si les LocalName propriétés de NamespaceURI l’élément trouvé correspondent aux chaînes donné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 à mettre en correspondance avec la LocalName propriété de l’élément trouvé.

ns

String

Chaîne à mettre en correspondance avec la NamespaceURI propriété 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 celui trouvé ou si les LocalName propriétés de NamespaceURI l’élément ne correspondent pas aux chaînes spécifiées.

Exceptions

XmlException

Le code XML incorrect est 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 ignore l’espace blanc, 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 teste si le nœud de contenu actuel est une balise de démarrage 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() une balise de début ou une balise d’élément vide est trouvée ; false si un type de nœud autre que celui trouvé XmlNodeType.Element .

Exceptions

XmlException

Le code XML incorrect est 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 ».

Exemples

L’exemple suivant affiche le contenu texte 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 l’espace blanc, 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() et teste si le nœud de contenu actuel est une balise de début ou une balise d’élément vide et si la Name propriété de l’élément trouvé correspond à l’argument donné.

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 correspondant à la Name propriété de l’élément trouvé.

Retours

Boolean

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

Exceptions

XmlException

Le code XML incorrect est 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 ».

Exemples

L’exemple suivant affiche chaque élément de prix.

// 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 l’espace blanc, 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()