XmlReader.ReadContentAsBoolean XmlReader.ReadContentAsBoolean XmlReader.ReadContentAsBoolean XmlReader.ReadContentAsBoolean Method

定義

現在の位置でテキスト コンテンツを Boolean として読み取ります。Reads the text content at the current position as a 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 オブジェクトとしてのテキスト コンテンツ。The text content as a Boolean object.

例外

試行されたキャストが無効です。The attempted cast is not valid.

文字列書式が無効です。The string format is not valid.

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。An XmlReader method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

次の例ではReadContentAsBoolean 、メソッドを使用しBooleanて、属性を値として読み取ります。The following example uses the ReadContentAsBoolean method to read the attribute as a Boolean value.

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 ファイルを入力として使用します。The example uses the dataFile_2.xml file as input.

<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 セクションを連結し、コメントや処理命令をスキップします。This method concatenates text, white space, significant white space, and CDATA sections, and skips any comments or processing instructions. エンティティ参照は自動的に解決されます。Entity references are automatically resolved.

コンテンツが型指定xsd:booleanされている場合、リーダーはボックス化解除されBooleanたオブジェクトを返します。If the content is typed xsd:boolean, the reader returns an unboxed Boolean object. コンテンツが型指定xsd:booleanされていない場合、リーダーは、 W3C Boolean XML スキーマパート2で定義されている規則に従って、オブジェクトへの変換を試みます。データ型の推奨。If the content is not typed xsd:boolean, the reader attempts to convert it to a Boolean object according to the rules defined by the W3C XML Schema Part 2: Datatypes recommendation.

次の表では、このメソッドが各ノード型を処理する方法について説明します。The following table describes how this method treats each node type.

XmlNodeTypeXmlNodeType 戻り値Return value リーダーの動作Reader behavior
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
テキストの連結されたコンテンツ、CDATA、空白、および有意の空白のノードが指定された型に変換されます。Concatenated content of text, CDATA, white space and significant white space nodes converted to the requested type. 次の要素開始タグまたは要素終了タグに移動します。Moves to the next start element or end element tag. エンティティ参照は自動的に展開されます。Entity references are automatically expanded.
Attribute 属性値にXmlConvert.ToXxx対してを呼び出す場合と同じです。Same as calling XmlConvert.ToXxx on the attribute value. リーダは現在の位置に留まります。The reader remains in the current position.
Comment

ProcessingInstruction
処理命令 (PI) またはコメントは無視し、PI またはコメントに続く連結されたテキスト コンテンツを読みます。Ignores the processing instruction (PI) or comment and reads the concatenated text content that follows the PI or comment. 次の要素開始タグまたは要素終了タグに移動します。Moves to the next start element or end element tag. エンティティ参照は自動的に展開されます。Entity references are automatically expanded.
EndElement 空の文字列。An empty string. リーダは現在の位置に留まります。The reader remains in the current position.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
InvalidOperationException がスローされます。An InvalidOperationException is thrown. 未定義。ただし、リーダーは通常、現在の位置に留まります。Undefined, although typically the reader remains in the current position.

詳細については、 XmlReaderリファレンスページと W3C XML スキーマパート2を参照してください。データ型の推奨。For more information, see the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

適用対象