XmlReader.ReadElementContentAsLong 方法

参考

定义

命名空间:: System.Xml

程序集:: System.Xml.ReaderWriter.dll

程序集:: System.Xml.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

读取当前元素并将内容作为 64 位有符号整数返回。

重载

ReadElementContentAsLong()	读取当前元素并将内容作为 64 位有符号整数返回。
ReadElementContentAsLong(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 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 位有符号整数的元素内容。

例外

InvalidOperationException

XmlReader 未定位在元素上。

或 -

在上一次异步操作完成之前调用了 XmlReader 方法。在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

XmlException

当前元素包含子元素。

或 -

无法将元素内容转换为 64 位有符号整数。

ArgumentNullException

使用 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 与当前元素的本地名称和命名空间 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