XmlReader.ReadElementContentAsFloat 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

以單精確度浮點數的形式讀取目前的項目值。

多載

ReadElementContentAsFloat()	以單精確度浮點數的形式，讀取目前的項目並傳回內容。
ReadElementContentAsFloat(String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以單精確度浮點數的形式，讀取目前的項目並傳回內容。

ReadElementContentAsFloat()

來源:

XmlReader.cs

以單精確度浮點數的形式，讀取目前的項目並傳回內容。

C#

public virtual float ReadElementContentAsFloat();

傳回

Single

單精確度浮點數形式的項目內容。

例外狀況

InvalidOperationException

XmlReader 並不是放置在項目上。

-或-

在先前的非同步作業完成前呼叫了 XmlReader 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

XmlException

目前的項目包含子項目。

-或-

項目內容無法轉換為單精確度浮點數。

ArgumentNullException

方法是以 null 引數呼叫。

備註

這個方法會讀取開始標籤、元素的內容，並將讀取器移至結束元素標籤的後面。 它會展開實體，並忽略處理指示和批註。 元素只能包含簡單內容。 也就是說，它不能有子專案。

讀取器會根據 W3C XML 架構第 2 部分：資料類型 建議所定義的規則，嘗試將專案內容轉換成單精確度浮點數。

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

ReadElementContentAsFloat(String, String)

來源:

XmlReader.cs

檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以單精確度浮點數的形式，讀取目前的項目並傳回內容。

C#

public virtual float ReadElementContentAsFloat(string localName, string namespaceURI);

參數

localName

String

項目的本機名稱。

namespaceURI

String

項目的命名空間 URI。

傳回

Single

單精確度浮點數形式的項目內容。

例外狀況

InvalidOperationException

XmlReader 並不是放置在項目上。

-或-

在先前的非同步作業完成前呼叫了 XmlReader 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

XmlException

目前的項目包含子項目。

-或-

項目內容無法轉換為單精確度浮點數。

ArgumentNullException

方法是以 null 引數呼叫。

ArgumentException

指定的區域名稱和命名空間 URI，與目前正在讀取的項目不相符。

備註

這個方法會讀取開始標籤、元素的內容，並將讀取器移至結束元素標籤的後面。 它會展開實體，並忽略處理指示和批註。 元素只能包含簡單內容。 也就是說，它不能有子專案。

讀取器會根據 W3C XML 架構第 2 部分：資料類型 建議所定義的規則，嘗試將專案內容轉換成單精確度浮點數。

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