XmlReader.ReadContentAsInt 方法
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
以 32 位元帶正負號之整數的形式讀取目前位置的文字內容。
public:
virtual int ReadContentAsInt();
C#
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 部分:資料類型 建議。
產品 | 版本 |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |