XPathNavigator.ValueAsBoolean Eigenschaft

Referenz

Definition

Namespace:: System.Xml.XPath

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XPath.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

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 : 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 einen Boolean konvertiert werden.

InvalidCastException

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 , ValueAsDateTime ValueAsDouble, 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.

Gilt für

Freigeben über