共用方式為


XmlReader.ReadElementContentAsLong 方法

定義

以 64 位元帶正負號之整數的形式讀取目前的元素並傳回內容。

多載

ReadElementContentAsLong()

以 64 位元帶正負號之整數的形式讀取目前的元素並傳回內容。

ReadElementContentAsLong(String, String)

檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符,然後以 64 位元帶正負號之整數的形式讀取目前的元素並傳回內容。

ReadElementContentAsLong()

以 64 位元帶正負號之整數的形式讀取目前的元素並傳回內容。

public:
 virtual long ReadElementContentAsLong();
public virtual long ReadElementContentAsLong ();
abstract member ReadElementContentAsLong : unit -> int64
override this.ReadElementContentAsLong : unit -> int64
Public Overridable Function ReadElementContentAsLong () As Long

傳回

Int64

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

例外狀況

XmlReader 並不是放置在項目上。

-或-

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

目前的項目包含子項目。

-或-

項目內容不能轉換為 64 位元帶正負號的整數。

方法是以 null 引數呼叫。

範例

下列範例會 ReadElementContentAsLong 使用 方法來讀取 專案的內容 longValue

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("longValue");
     long number = reader.ReadElementContentAsLong();
     // Do some processing with the number object.
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("longValue")
  Dim number As Long = reader.ReadElementContentAsLong()
  ' Do some processing with the number object.
End Using

該範例使用 dataFile.xml 檔案做為輸入。

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

備註

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

如果內容類型為 xsd:long ,讀取器會傳回未收件匣的 64 位帶正負號整數。 如果未輸入 xsd:long 內容,讀取器會根據 W3C XML 架構第 2 部分:資料類型 建議所定義的規則,嘗試將它轉換成 64 位帶正負號的整數。

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

適用於

ReadElementContentAsLong(String, String)

檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符,然後以 64 位元帶正負號之整數的形式讀取目前的元素並傳回內容。

public:
 virtual long ReadElementContentAsLong(System::String ^ localName, System::String ^ namespaceURI);
public virtual long ReadElementContentAsLong (string localName, string namespaceURI);
abstract member ReadElementContentAsLong : string * string -> int64
override this.ReadElementContentAsLong : string * string -> int64
Public Overridable Function ReadElementContentAsLong (localName As String, namespaceURI As String) As Long

參數

localName
String

項目的本機名稱。

namespaceURI
String

項目的命名空間 URI。

傳回

Int64

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

例外狀況

XmlReader 並不是放置在項目上。

-或-

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

目前的項目包含子項目。

-或-

項目內容不能轉換為 64 位元帶正負號的整數。

方法是以 null 引數呼叫。

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

備註

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

如果內容類型為 xsd:long ,讀取器會傳回未收件匣的 64 位帶正負號整數。 如果未輸入 xsd:long 內容,讀取器會根據 W3C XML 架構第 2 部分:資料類型 建議所定義的規則,嘗試將它轉換成 64 位帶正負號的整數。

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

適用於