XmlReader.ReadContentAsDateTime 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

将当前位置的文本内容作为 DateTime 对象读取。

public:
 virtual DateTime ReadContentAsDateTime();

public virtual DateTime ReadContentAsDateTime ();

abstract member ReadContentAsDateTime : unit -> DateTime
override this.ReadContentAsDateTime : unit -> DateTime

Public Overridable Function ReadContentAsDateTime () As DateTime

返回

DateTime

作为 DateTime 对象的文本内容。

例外

InvalidCastException

试图进行的强制转换无效。

FormatException

该字符串格式无效。

InvalidOperationException

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

注解

此方法连接文本、空白、重大空白和 CDATA 部分，并跳过任何注释或处理指令。 会自动解析实体引用。

如果键入 xsd:dateTime内容，则读取器将返回未装箱 DateTime 的对象。 如果未键入xsd:dateTime内容，则读取器会根据 W3C XML 架构第 2 部分：数据类型建议定义的规则将其DateTime转换为对象。

备注

如果内容类型化为 DateTime.Year，则不能使用 xsd:gMonthDay 值。 XmlReader 在这种情况下，始终将 DateTime.Year 值设置为 1904。

下表介绍了此方法如何处理每个节点类型。

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 部分：数据类型 建议。