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 部分：資料型別建議所定義的規則，嘗試將其轉換為物件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 架構第二部分：資料型 別建議。