XPathNavigator.ValueAsBoolean Eigenschaft

Definition

Namespace:

System.Xml.XPath

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XPathNavigator.cs

Ruft den Wert des aktuellen Knotens als ein Boolean.

public:
 virtual property bool ValueAsBoolean { bool get(); };

public override bool ValueAsBoolean { get; }

member this.ValueAsBoolean : bool

Public Overrides ReadOnly Property ValueAsBoolean As Boolean

Eigenschaftswert

Boolean

Der Wert des aktuellen Knotens als .Boolean

Ausnahmen

FormatException

Der Zeichenfolgenwert des aktuellen Knotens kann nicht in ein Boolean.

InvalidCastException

Die versuchte Umwandlung ist Boolean ungültig.

Beispiele

Im folgenden Beispiel wird der Wert der einzelnen Elemente in der valueas.xml Datei mithilfe der ValueAsBooleanEigenschaften , ValueAsDateTime, , ValueAsDouble, ValueAsIntund ValueAsLong Eigenschaften zurückgegeben.

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)

Im Beispiel wird die valueas.xml Datei 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 enthalten (z. B. aus einem XmlDocument Objekt, das mit einer 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 gemäß den XPath 2.0-Umwandlungsregeln in xs:booleaneinen Boolean Wert zu konvertieren.