XmlReader.ReadContentAsBoolean Méthode

Définition

Espace de noms:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlReader.cs

Lit le contenu du texte à la position actuelle en tant que 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 texte en tant qu’objet Boolean .

Exceptions

InvalidCastException

La tentative de cast n’est pas valide.

FormatException

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

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 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 utilise le dataFile_2.xml fichier 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 tapé 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 objet Boolean conformément aux règles définies par la partie 2 du schéma XML W3C : recommandation datatypes .

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

XmlNodeType	Valeur renvoyée	Comportement du lecteur
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Contenu concaténé de texte, CDATA, espace blanc et nœuds d’espace blanc significatifs convertis en type demandé.	Passe à l’élément de début ou à la balise d’élément de fin suivant. 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 à la position actuelle.
Comment ProcessingInstruction	Ignore l’instruction de traitement (PI) ou le commentaire et lit le contenu de texte concaténé qui suit le pi ou le commentaire.	Passe à l’élément de début ou à la balise d’élément de fin suivant. Les références d’entité sont automatiquement développées.
EndElement	Chaîne vide.	Le lecteur reste à la position actuelle.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Une InvalidOperationException est levée.	Non défini, bien que le lecteur reste généralement dans la position actuelle.

Pour plus d’informations, consultez la XmlReader page de référence et la recommandation W3C XML Schema Part 2 : Datatypes .