XmlReader.ReadElementContentAsLong 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
以 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 -> int64Public Overridable Function ReadElementContentAsLong () As Long傳回
64 位元帶正負號之整數形式的元素內容。
例外狀況
XmlReader 並不是放置在項目上。
-或-
在先前的非同步作業完成前呼叫了 XmlReader 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。
方法是以 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 -> int64Public Overridable Function ReadElementContentAsLong (localName As String, namespaceURI As String) As Long參數
- localName
- String
項目的本機名稱。
- namespaceURI
- String
項目的命名空間 URI。
傳回
64 位元帶正負號之整數形式的元素內容。
例外狀況
XmlReader 並不是放置在項目上。
-或-
在先前的非同步作業完成前呼叫了 XmlReader 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。
方法是以 null 引數呼叫。
指定的區域名稱和命名空間 URI，與目前正在讀取的項目不相符。
備註
這個方法會讀取開始標籤、元素的內容，並將讀取器移至結束元素標籤的後面。 它會展開實體，並忽略處理指示和批註。 元素只能包含簡單內容。 也就是說，它不能有子專案。
如果內容類型為 xsd:long ，讀取器會傳回未收件匣的 64 位帶正負號整數。 如果未輸入 xsd:long 內容，讀取器會根據 W3C XML 架構第 2 部分：資料類型 建議所定義的規則，嘗試將它轉換成 64 位帶正負號的整數。
如需詳細資訊，請參閱 XmlReader 參考頁面的＜備註＞一節。