XPathNavigator.ValueAsBoolean プロパティ

.NET Framework クラス ライブラリ リファレンス

XPathNavigator.ValueAsBoolean プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在のノードの値を Boolean として取得します。

名前空間: System.Xml.XPath
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overrides ReadOnly
 Property ValueAsBoolean As Boolean

Visual Basic (使用法)

Dim instance As XPathNavigator
Dim value As Boolean

value = instance.ValueAsBoolean

C#

public override bool ValueAsBoolean { get;
 }

C++

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

J#

/** @property */
public boolean get_ValueAsBoolean ()

JScript

public override function get
 ValueAsBoolean () : boolean

プロパティ値
現在のノードの Boolean としての値。

例外

例外の種類	条件
FormatException	現在のノードの文字列値を、Boolean に変換することはできません。
InvalidCastException	試行された Boolean へのキャストは無効です。

解説

XPathNavigator が、たとえば、XmlReader を検証する XML スキーマで初期化された XmlDocument オブジェクトからのスキーマ情報または型情報を持っている場合や、現在のノードが XML スキーマ xs:boolean 型として定義されている場合、ValueAsBoolean プロパティは現在のノードの値を、ボックス化が解除された Boolean オブジェクトとして返します。

ただし、XPathNavigator がスキーマ情報または型情報を持っていない場合、ValueAsBoolean プロパティは、xs:boolean の XPath 2.0 キャスティング規則に従い、現在のノードの文字列値を Boolean 値に変換しようとします。

使用例

valueas.xml ファイル内の各要素の値を、ValueAsBoolean、ValueAsDateTime、ValueAsDouble、ValueAsInt、および ValueAsLong の各プロパティを使用して返す例を次に示します。

Visual Basic

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)

C#

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

この例では、入力として、valueas.xml というファイルを使用しています。

<root>
    <booleanElement>true</booleanElement>
    <dateTimeElement>2004-04-20T12:00:00</dateTimeElement>
    <decimalElement>10.00</decimalElement>
    <numberElement>100000000</numberElement>
</root>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
XPathNavigator クラス
XPathNavigator メンバ
System.Xml.XPath 名前空間