XmlReader.ReadContentAsBoolean メソッド

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

XmlReader.ReadContentAsBoolean メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

現在の位置でテキストの内容を Boolean として読み取ります。

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

Visual Basic (宣言)

Public Overridable Function
 ReadContentAsBoolean As Boolean

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnValue As Boolean

returnValue = instance.ReadContentAsBoolean

C#

public virtual bool ReadContentAsBoolean ()

C++

public:
virtual bool ReadContentAsBoolean ()

J#

public boolean ReadContentAsBoolean ()

JScript

public function ReadContentAsBoolean () : boolean

戻り値
Boolean オブジェクトとしてのテキストの内容。

例外

例外の種類	条件
InvalidCastException	試行されたキャストが無効です。
FormatException	文字列書式が無効です。

解説

このメソッドは、テキスト、空白、有意の空白、および CDATA セクションを連結し、すべてのコメントまたは処理命令をスキップします。エンティティ参照は自動的に解決されます。

内容が型指定された xsd:boolean の場合、リーダーは、ボックス化が解除された Boolean オブジェクトを返します。内容が型指定されていない xsd:boolean の場合、リーダーは、W3C 勧告『XML Schema Part 2: Datatypes』(http://www.w3.org/TR/xmlschema-2/) によって定義された規則に従って Boolean オブジェクトに変換しようとします。

このメソッドで各ノード型がどのように処理されるかについて、次の表に示します。

XmlNodeType	戻り値	リーダーの動作
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	連結されたテキストの内容、CDATA、空白、および要求された型に変換された有意な空白ノード。	次の開始要素タグまたは終了要素タグに移動します。エンティティ参照は自動的に展開されます。
Attribute	属性値による XmlConvert.ToXxx の呼び出しと同じ。	リーダーは、現在の位置から変わりません。
Comment ProcessingInstruction	処理命令 (PI) またはコメントを無視し、PI またはコメントに続く、連結されたテキストの内容を読み込みます。	次の開始要素タグまたは終了要素タグに移動します。エンティティ参照は自動的に展開されます。
EndElement	空の文字列。	リーダーは、現在の位置から変わりません。
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	InvalidOperationException がスローされます。	未定義。ただし、リーダー (読み取り機能) は現在の位置にとどまるのが一般的です。

詳細については、「型指定されたデータの読み取り」および W3C 勧告『XML Schema Part 2: Datatypes』(http://www.w3.org/TR/xmlschema-2/) を参照してください。

使用例

ReadContentAsBoolean メソッドを使用して属性を Boolean 値として読み取る例を次に示します。

Visual Basic

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

C#

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

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlReader クラス
XmlReader メンバ
System.Xml 名前空間
その他の技術情報
型指定されたデータの読み取り