System.Xml.XmlReader.ReadElementContentAsDateTime 方法

方法描述

读取当前元素并将内容作为 DateTime 对象返回。

语法定义(C# System.Xml.XmlReader.ReadElementContentAsDateTime 方法 的用法)

public virtual DateTime ReadElementContentAsDateTime()

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
返回值 System.DateTime 作为 DateTime 对象的元素内容。

提示和注释

此方法读取开始标记、元素内容,并将读取器移到结尾元素标记之后。 它将展开实体并忽略处理指令和注释。 该元素只能包含简单内容。 也就是说,它不能有子元素。

如果内容为类型化的 xsd:dateTime,则读取器将返回取消装箱的 DateTime 对象。 如果内容不是类型化的 xsd:dateTime,则读取器根据 W3C XML Schema Part 2: Datatypes(W3C XML 架构第 2 部分:数据类型)建议所定义的规则尝试将它转换为 DateTime 对象。

注意

当内容被类型化为 xsd:gMonthDay 以后,就无法依赖 DateTime.Year 值。 在此事例中,XmlReader 始终将 DateTime.Year 值设置为 1904。

有关更多信息,请参见 读取类型化数据。

System.Xml.XmlReader.ReadElementContentAsDateTime 方法例子

该示例将 dataFile.xml 文件用作输入。


  
     
     
      text value of the element.
  
  270000000000001
  0
  2E10
  2003-01-08T15:00:00-00:00

异常

异常 异常描述
InvalidOperationException XmlReader 未定位在元素上。
XmlException
  • 当前元素包含子元素。
  • 元素内容不能转换为 DateTime 对象。
ArgumentNullException 使用 null 参数调用此方法。

命名空间

namespace: System.Xml

程序集: System.Xml(在 System.Xml.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。