XmlReader.ReadContentAsBoolean Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Quelle:

XmlReader.cs

Liest den Textinhalt an der aktuellen Position als 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

Gibt zurück

Boolean

Der Textinhalt als Boolean-Objekt.

Ausnahmen

InvalidCastException

Die versuchte Typumwandlung ist ungültig.

FormatException

Das Zeichenfolgenformat ist nicht gültig.

InvalidOperationException

Eine XmlReader-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Beispiele

Im folgenden Beispiel wird die ReadContentAsBoolean -Methode verwendet, um das Attribut als Wert Boolean zu lesen.

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

In diesem Beispiel wird die Datei dataFile_2.xml als Eingabe verwendet.

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

Hinweise

Diese Methode verkettet Text, Leerzeichen, signifikante Leerzeichen und CDATA-Abschnitte und überspringt kommentare oder Verarbeitungsanweisungen. Entitätsverweise werden automatisch aufgelöst.

Wenn der Inhalt typisiert xsd:booleanist, gibt der Reader ein unboxed-Objekt Boolean zurück. Wenn der Inhalt nicht typisiert xsd:booleanist, versucht der Reader, ihn gemäß den Regeln, die durch die Empfehlung W3C XML Schema Part 2: Datatypes definiert werden, in ein Boolean Objekt zu konvertieren.

In der folgenden Tabelle wird beschrieben, wie diese Methode jeden Knotentyp behandelt.

XmlNodeType	Rückgabewert	Verhalten des Readers
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Verketteter Inhalt von Text, CDATA, Leerraum und signifikantem Leerraumknoten, konvertiert in den angeforderten Typ.	Wird zum nächsten Anfangselement- oder Endelementtag verschoben. Entitätsverweise werden automatisch erweitert.
Attribute	Identisch mit dem Aufrufen XmlConvert.ToXxx des Attributwerts.	Der Reader behält die aktuelle Position bei.
Comment ProcessingInstruction	Ignoriert die Verarbeitungsanweisung oder den Kommentar und liest den verketteten Textinhalt, der auf die Verarbeitungsanweisung oder den Kommentar folgt.	Wird zum nächsten Anfangselement- oder Endelementtag verschoben. Entitätsverweise werden automatisch erweitert.
EndElement	Eine leere Zeichenfolge.	Der Reader behält die aktuelle Position bei.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Es wird eine InvalidOperationException ausgelöst.	Nicht definiert, der Reader behält jedoch i. d. R. die aktuelle Position bei.

Weitere Informationen finden Sie auf der XmlReader Referenzseite und in der Empfehlung W3C XML Schema Part 2: Datatypes( W3C XML Schema Part 2: Datatypes ).