XmlReader.ReadContentAsInt 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
以 32 位元帶正負號之整數的形式讀取目前位置的文字內容。
public:
virtual int ReadContentAsInt();
public virtual int ReadContentAsInt ();
abstract member ReadContentAsInt : unit -> int
override this.ReadContentAsInt : unit -> int
Public Overridable Function ReadContentAsInt () As Integer
傳回
32 位元帶正負號之整數形式的文字內容。
例外狀況
嘗試的轉換無效。
字串格式無效。
在先前的非同步作業完成前呼叫了 XmlReader 方法。 在此情況下,會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。
備註
此方法會串連文字、空白字元、重大空白字元和 CDATA 區段,並略過任何批註或處理指示。 實體參考會自動解析。
如果內容類型為 xsd:integer
,則讀取器會傳回未收件匣的 32 位帶正負號整數。 如果未輸入 xsd:integer
內容,讀取器會根據 W3C XML 架構第 2 部分:資料類型 建議所定義的規則,嘗試將它轉換成 32 位帶正負號的整數。
下表描述此方法如何處理每個節點類型。
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 一節和 W3C XML 架構第 2 部分:資料類型 建議。