XmlReader.ReadContentAsBoolean メソッド

定義

名前空間:

System.Xml

アセンブリ:

netstandard.dll, System.Xml.ReaderWriter.dll

ソース:

XmlReader.cs

現在の位置にあるテキスト コンテンツを Booleanとして読み取ります。

public:
 virtual bool ReadContentAsBoolean();

public virtual bool ReadContentAsBoolean();

abstract member ReadContentAsBoolean : unit -> bool
override this.ReadContentAsBoolean : unit -> bool

Public Overridable Function ReadContentAsBoolean () As Boolean

返品

Boolean

Boolean オブジェクトとしてのテキスト コンテンツ。

例外

InvalidCastException

試行されたキャストが無効です。

FormatException

文字列形式が無効です。

InvalidOperationException

前の非同期操作が完了する前に、 XmlReader メソッドが呼び出されました。 この場合、"非同期操作は既に進行中です" というメッセージで InvalidOperationException がスローされます。

例

次の例では、 ReadContentAsBoolean メソッドを使用して、属性を Boolean 値として読み取います。

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

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

この例では、 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>

注釈

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

コンテンツが xsd:boolean型指定されている場合、リーダーはボックス化されていない Boolean オブジェクトを返します。 コンテンツがxsd:boolean型指定されていない場合、リーダーは W3C XML スキーマ パート 2: Datatypes に関する推奨事項で定義されている規則に従って、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がスローされます。	未定義ですが、通常、リーダーは現在の位置に残ります。

詳細については、 XmlReader リファレンス ページと W3C XML スキーマパート 2: データ型に関する 推奨事項を参照してください。