XmlReader.ReadContentAsFloat 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlReader.cs

將當前位置的文字內容讀取為單精度浮點數。

public:
 virtual float ReadContentAsFloat();

public virtual float ReadContentAsFloat();

abstract member ReadContentAsFloat : unit -> single
override this.ReadContentAsFloat : unit -> single

Public Overridable Function ReadContentAsFloat () As Single

傳回

Single

目前位置的文字以單精度浮點數形式呈現。

例外狀況

InvalidCastException

嘗試的演員陣容並不有效。

FormatException

字串格式不適用。

InvalidOperationException

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

備註

此方法串接文字、空白空間、顯著空白與 CDATA 區段，並跳過任何註解或處理指令。 實體參考會自動解決。

若內容輸入 xsd:float為 ，讀取器會回傳一個未開框的單精度浮點數。 若內容未輸入 xsd:float，讀取器將依 據 W3C XML 架構第 2 部分：資料型別 建議所定義的規則，嘗試將其轉換為單精度浮點數。

下表說明此方法如何處理每種節點類型。

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 架構第二部分：資料型別 建議。