XmlReader.ReadContentAsLong 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlReader.cs

將當前位置的文字內容讀取為 64 位元的有號整數。

public:
 virtual long ReadContentAsLong();

public virtual long ReadContentAsLong();

abstract member ReadContentAsLong : unit -> int64
override this.ReadContentAsLong : unit -> int64

Public Overridable Function ReadContentAsLong () As Long

傳回

Int64

文字內容為 64 位元有號整數。

例外狀況

InvalidCastException

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

FormatException

字串格式不適用。

InvalidOperationException

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

備註

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

若內容輸入 xsd:long為 ，讀取器會回傳一個未開框的 64 位元有符號整數。 若內容未輸入 xsd:long，讀取器將依 據 W3C XML 架構第 2 部分：資料型別 建議所定義的規則，嘗試將其轉換為 64 位元有號整數。

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

XmlNodeType	返回值	讀者行為
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	串接內容的文字、CDATA、空白空間及重要空白節點轉換為所需類型。	移動到下一個起始元素或結束元素標籤。 實體參考會自動展開。
Attribute	和屬性值一樣 XmlConvert.ToXxx 。	讀者仍停留在當前位置
Comment ProcessingInstruction	忽略處理指令（PI）或註解，閱讀緊接在 PI 或註解後的串接文字內容。	移動到下一個起始元素或結束元素標籤。 實體參考會自動展開。
EndElement	空字串。	讀者仍停留在當前位置。
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	An InvalidOperationException 被拋出。	未定義，但通常讀者仍停留在當前位置。

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