XmlReader.ReadContentAsBoolean メソッド

定義

名前空間:

System.Xml

アセンブリ:

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: データ型に関する推奨事項で定義されている規則に従って、オブジェクトへの変換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 スキーマ パート 2: データ型に関する推奨事項を参照XmlReaderしてください。