共用方式為


XmlReader.ReadContentAsLong 方法

定義

以 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

傳回

64 位元帶正負號之整數形式的文字內容。

例外狀況

嘗試的轉換無效。

字串格式無效。

在先前的非同步作業完成前呼叫了 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
擲回 InvalidOperationException 未定義 (但讀取器通常會保持在目前位置)。

如需詳細資訊,請參閱 XmlReader 參考頁面的<備註>一節。

適用於