XmlReader.ReadElementContentAsBoolean 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

它會將當前元素的值讀作物件 Boolean 。

多載

名稱	Description
ReadElementContentAsBoolean(String, String)	檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取該當前元素並將內容作為 Boolean 物件回傳。
ReadElementContentAsBoolean()	讀取目前元素，並將內容以 Boolean 物件形式回傳。

ReadElementContentAsBoolean(String, String)

來源:

XmlReader.cs

檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取該當前元素並將內容作為 Boolean 物件回傳。

public:
 virtual bool ReadElementContentAsBoolean(System::String ^ localName, System::String ^ namespaceURI);

public virtual bool ReadElementContentAsBoolean(string localName, string namespaceURI);

abstract member ReadElementContentAsBoolean : string * string -> bool
override this.ReadElementContentAsBoolean : string * string -> bool

Public Overridable Function ReadElementContentAsBoolean (localName As String, namespaceURI As String) As Boolean

參數

localName

String

該元素的地方名稱。

namespaceURI

String

元素的命名空間 URI。

傳回

Boolean

元素內容作為 Boolean 物件。

例外狀況

InvalidOperationException

它 XmlReader 並未被定位在元素上。

-或-

在先前非同步操作結束前，會呼叫一個 XmlReader 方法。 此時， InvalidOperationException 會拋出「非同步操作已進行中」的訊息。

XmlException

目前元素包含子元素。

-或-

元素內容無法轉換為所請求的類型。

ArgumentNullException

此方法以參數呼叫 null 。

ArgumentException

指定的本地名稱與命名空間 URI 與目前被讀取的元素不符。

備註

此方法讀取起始標籤、元素內容，並將讀取器移過終點元素標籤。 它會擴展實體，並忽略處理指令與註解。 該元素只能包含簡單內容。 也就是說，它不能有子元素。

若內容被輸入 xsd:boolean為 ，讀取器會回傳一個未 Boolean 開箱物件。 若內容未被輸入xsd:boolean型別，讀取器將依照 W3C XML 架構第 2 部分：資料型別建議所定義的規則，嘗試將其轉換為物件Boolean。

如需詳細資訊，請參閱 XmlReader 參考頁面的＜備註＞一節。

ReadElementContentAsBoolean()

來源:

XmlReader.cs

讀取目前元素，並將內容以 Boolean 物件形式回傳。

public:
 virtual bool ReadElementContentAsBoolean();

public virtual bool ReadElementContentAsBoolean();

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

Public Overridable Function ReadElementContentAsBoolean () As Boolean

傳回

Boolean

元素內容作為 Boolean 物件。

例外狀況

InvalidOperationException

它 XmlReader 並未被定位在元素上。

-或-

在先前非同步操作結束前，會呼叫一個 XmlReader 方法。 此時， InvalidOperationException 會拋出「非同步操作已進行中」的訊息。

XmlException

目前元素包含子元素。

-或-

元素內容無法轉換成 Boolean 物件。

ArgumentNullException

此方法以參數呼叫 null 。

備註

此方法讀取起始標籤、元素內容，並將讀取器移過終點元素標籤。 它會擴展實體，並忽略處理指令與註解。 該元素只能包含簡單內容。 也就是說，它不能有子元素。

若元素內容被輸入 xsd:boolean為 ，讀取器會回傳一個未 Boolean 開箱物件。 若內容未被輸入xsd:boolean型別，讀取器將依照 W3C XML 架構第 2 部分：資料型別建議所定義的規則，嘗試將其轉換為物件Boolean。

如需詳細資訊，請參閱 XmlReader 參考頁面的＜備註＞一節。