XmlReader.ReadContentAsBoolean Méthode

Référence

Définition

Espace de noms:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Lit le contenu de texte à la position actuelle comme un Boolean.

public:
 virtual bool ReadContentAsBoolean();

public virtual bool ReadContentAsBoolean ();

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

Public Overridable Function ReadContentAsBoolean () As Boolean

Retours

Boolean

Contenu de texte sous la forme d'un objet Boolean.

Exceptions

InvalidCastException

La tentative de cast n'est pas valide.

FormatException

Le format de chaîne n'est pas valide.

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 utilise la ReadContentAsBoolean méthode pour lire l’attribut en tant que Boolean valeur.

using (XmlReader reader = XmlReader.Create("dataFile_2.xml")) {
      reader.ReadToDescendant("item");
      do {
          reader.MoveToAttribute("sale-item");
          Boolean onSale = reader.ReadContentAsBoolean();
          if (onSale) {
             Console.WriteLine(reader["productID"]);
          }
      } while (reader.ReadToNextSibling("item"));	
}

Using reader As XmlReader = XmlReader.Create("dataFile_2.xml")
              
  reader.ReadToDescendant("item")
              
  Do
    reader.MoveToAttribute("sale-item")
    Dim onSale As [Boolean] = reader.ReadContentAsBoolean()
    If onSale Then
      Console.WriteLine(reader("productID"))
    End If
  Loop While reader.ReadToNextSibling("item")
          
End Using

L'exemple prend le fichier dataFile_2.xml comme entrée.

<root>
  <item sale-item='true' productID='123456' colors='blue green black'>
    <price>9.95</price>
  </item>
  <item sale-item='false' productID='124390'>
    <price>5.95</price>
  </item>
  <item sale-item='true' productID='53298'>
    <price>12.95</price>
  </item>
</root>

Remarques

Cette méthode concaténe du texte, de l’espace blanc, de l’espace blanc significatif et des sections CDATA, et ignore les commentaires ou instructions de traitement. Les références d’entité sont résolues automatiquement.

Si le contenu est typé xsd:boolean, le lecteur retourne un objet nonboxé Boolean . Si le contenu n’est pas typé xsd:boolean, le lecteur tente de le convertir en Boolean objet en fonction des règles définies par la partie 2 du schéma XML W3C : recommandation de types de données .

Le tableau suivant décrit comment cette méthode traite chaque type de nœud.

XmlNodeType	Valeur retournée	Comportement du lecteur
`Text` `CDATA` `Whitespace` `SignificantWhitespace` `EntityReference` `EndEntity`	Nœuds de contenus de texte, CDATA, d'espace blanc et d'espace blanc significatif concaténés convertis en type demandé.	Avance jusqu'à la balise d'élément de début ou de fin suivante. Les références d’entité sont automatiquement développées.
`Attribute`	Identique à l’appel `XmlConvert.ToXxx` de la valeur d’attribut.	Le lecteur reste dans sa position actuelle.
`Comment` `ProcessingInstruction`	Ignore l'instruction de traitement ou le commentaire et lit le contenu du texte concaténé qui suit l'instruction ou le commentaire.	Avance jusqu'à la balise d'élément de début ou de fin suivante. Les références d’entité sont automatiquement développées.
`EndElement`	Chaîne vide.	Le lecteur reste dans sa position actuelle.
`Element` `XmlDeclaration` `None` `Document` `DocumentType` `Notation` `Entity` `DocumentFragment`	Un objet InvalidOperationException est levé.	Non défini, bien que le lecteur reste généralement dans sa position actuelle.

Pour plus d’informations, consultez la XmlReader page de référence et la partie 2 du schéma XML W3C : Recommandation sur les types de données .

S’applique à

Partager via