XmlReader.ReadContentAsLong 方法

定义

命名空间:

System.Xml

程序集:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlReader.cs

以 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

返回

Int64

文本内容为 64 位带符号整数。

例外

InvalidCastException

尝试的强制转换无效。

FormatException

字符串格式无效。

InvalidOperationException

在上一个异步操作完成之前调用了一个 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	将引发 An InvalidOperationException 。	未定义，尽管读取器通常保留在当前位置。

有关详细信息，请参阅 XmlReader 引用页的“备注”部分。