XPathNavigator.ValueAsBoolean Eigenschaft
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.
Ruft den Wert des aktuellen Knotens als Boolean ab.
public:
virtual property bool ValueAsBoolean { bool get(); };public override bool ValueAsBoolean { get; }member this.ValueAsBoolean : boolPublic Overrides ReadOnly Property ValueAsBoolean As BooleanEigenschaftswert
Der Wert des aktuellen Knotens als Boolean.
Ausnahmen
Der Zeichenfolgenwert des aktuellen Knotens kann nicht in einen Boolean konvertiert werden.
Die versuchte Typumwandlung in Boolean ist ungültig.
Beispiele
Im folgenden Beispiel wird der Wert jedes Elements in der valueas.xml Datei mithilfe der ValueAsBooleanEigenschaften , ValueAsDateTimeValueAsDouble, ValueAsIntund ValueAsLong Eigenschaften zurückgegeben.
XPathDocument^ document = gcnew XPathDocument("valueas.xml");
XPathNavigator^ navigator = document->CreateNavigator();
// ValueAsBoolean
navigator->MoveToChild("root", "");
navigator->MoveToChild("booleanElement", "");
bool^ booleanValue = navigator->ValueAsBoolean;
Console::WriteLine(navigator->LocalName + ": " + booleanValue);
// ValueAsDateTime
navigator->MoveToNext("dateTimeElement", "");
DateTime^ dateTimeValue = navigator->ValueAsDateTime;
Console::WriteLine(navigator->LocalName + ": " + dateTimeValue);
// ValueAsDouble, ValueAsInt32, ValueAsInt64, ValueAsSingle
navigator->MoveToNext("numberElement", "");
Double doubleValue = navigator->ValueAsDouble;
Int32 int32Value = navigator->ValueAsInt;
Int64 int64Value = navigator->ValueAsLong;
Console::WriteLine(navigator->LocalName + ": " + doubleValue);
Console::WriteLine(navigator->LocalName + ": " + int32Value);
Console::WriteLine(navigator->LocalName + ": " + int64Value);
XPathDocument document = new XPathDocument("valueas.xml");
XPathNavigator navigator = document.CreateNavigator();
// ValueAsBoolean
navigator.MoveToChild("root", "");
navigator.MoveToChild("booleanElement", "");
bool booleanValue = navigator.ValueAsBoolean;
Console.WriteLine(navigator.LocalName + ": " + booleanValue);
// ValueAsDateTime
navigator.MoveToNext("dateTimeElement", "");
DateTime dateTimeValue = navigator.ValueAsDateTime;
Console.WriteLine(navigator.LocalName + ": " + dateTimeValue);
// ValueAsDouble, ValueAsInt32, ValueAsInt64, ValueAsSingle
navigator.MoveToNext("numberElement", "");
Double doubleValue = navigator.ValueAsDouble;
Int32 int32Value = navigator.ValueAsInt;
Int64 int64Value = navigator.ValueAsLong;
Console.WriteLine(navigator.LocalName + ": " + doubleValue);
Console.WriteLine(navigator.LocalName + ": " + int32Value);
Console.WriteLine(navigator.LocalName + ": " + int64Value);
Dim document As XPathDocument = New XPathDocument("valueas.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()
' ValueAsBoolean
navigator.MoveToChild("root", "")
navigator.MoveToChild("booleanElement", "")
Dim booleanValue As Boolean = navigator.ValueAsBoolean
Console.WriteLine(navigator.LocalName + ": " + booleanValue)
' ValueAsDateTime
navigator.MoveToNext("dateTimeElement", "")
Dim dateTimeValue As DateTime = navigator.ValueAsDateTime
Console.WriteLine(navigator.LocalName + ": " + dateTimeValue)
' ValueAsDouble, ValueAsInt32, ValueAsInt64, ValueAsSingle
navigator.MoveToNext("numberElement", "")
Dim doubleValue As Double = navigator.ValueAsDouble
Dim int32Value As Int32 = navigator.ValueAsInt
Dim int64Value As Int64 = navigator.ValueAsLong
Console.WriteLine(navigator.LocalName + ": " + doubleValue)
Console.WriteLine(navigator.LocalName + ": " + int32Value)
Console.WriteLine(navigator.LocalName + ": " + int64Value)
In diesem Beispiel wird die Datei valueas.xml als Eingabe verwendet.
<root>
<booleanElement>true</booleanElement>
<dateTimeElement>2004-04-20T12:00:00</dateTimeElement>
<decimalElement>10.00</decimalElement>
<numberElement>100000000</numberElement>
</root>
Hinweise
Wenn die XPathNavigator Schema- oder Typinformationen (z. B. aus einem Objekt, das mit einer XmlDocument XML-Schemaüberprüfung XmlReaderinitialisiert wurde), und wenn der aktuelle Knoten als XML-Schematyp xs:boolean definiert ist, gibt die ValueAsBoolean Eigenschaft den Wert des aktuellen Knotens als unboxiertes Boolean Objekt zurück.
Wenn jedoch XPathNavigator keine Schema- oder Typinformationen vorhanden sind, versucht die ValueAsBoolean Eigenschaft, den Zeichenfolgenwert des aktuellen Knotens in einen Boolean Wert zu konvertieren, entsprechend den XPath 2.0-Umwandlungsregeln für xs:boolean.