XmlReader.ReadContentAsBoolean Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest den Textinhalt an der aktuellen Position als ein Boolean.
public:
virtual bool ReadContentAsBoolean();public virtual bool ReadContentAsBoolean();abstract member ReadContentAsBoolean : unit -> bool
override this.ReadContentAsBoolean : unit -> boolPublic Overridable Function ReadContentAsBoolean () As BooleanGibt zurück
Der Textinhalt als Boolean Objekt.
Ausnahmen
Die versuchte Umwandlung ist ungültig.
Das Zeichenfolgenformat ist ungültig.
Eine XmlReader Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits ausgeführt" ausgelöst.
Beispiele
Im folgenden Beispiel wird die ReadContentAsBoolean Methode verwendet, um das Attribut als Boolean Wert 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
Im Beispiel wird die dataFile_2.xml Datei 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, signifikanten Leerraum und CDATA-Abschnitte und überspringt Kommentare oder Verarbeitungsanweisungen. Entitätsverweise werden automatisch aufgelöst.
Wenn der Inhalt eingegeben xsd:booleanwird, gibt der Leser ein unboxiertes Boolean Objekt zurück. Wenn der Inhalt nicht eingegeben xsd:booleanwird, versucht der Leser, ihn gemäß den von der Empfehlung "W3C XML Schema Part 2: Datatypes" definierten Regeln in ein Boolean Objekt zu konvertieren.
In der folgenden Tabelle wird beschrieben, wie diese Methode jeden Knotentyp behandelt.
| Xmlnodetype | Zurückgegebener Wert | Leseverhalten |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
Verketteter Inhalt von Text, CDATA, Leerzeichen und signifikanten Leerraumknoten, die in den angeforderten Typ konvertiert wurden. | Wechselt zum nächsten Startelement- oder Endelementtag. Entitätsverweise werden automatisch erweitert. |
Attribute |
Identisch mit dem Aufrufen XmlConvert.ToXxx des Attributwerts. |
Der Leser verbleibt an der aktuellen Position. |
CommentProcessingInstruction |
Ignoriert die Verarbeitungsanweisung (PI) oder den Kommentar und liest den verketteten Textinhalt, der auf die PI oder den Kommentar folgt. | Wechselt zum nächsten Startelement- oder Endelementtag. Entitätsverweise werden automatisch erweitert. |
EndElement |
Eine leere Zeichenfolge. | Der Leser verbleibt an der aktuellen Position. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
Es InvalidOperationException wird eingeworfen. | Undefiniert, obwohl der Leser in der Regel an der aktuellen Position bleibt. |
Weitere Informationen finden Sie auf der XmlReader Referenzseite und im W3C XML-Schemateil 2: Empfehlung für Datentypen .
