通过


XmlReader.ReadContentAsDateTime 方法

定义

将当前位置的文本内容作为对象 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

例外

尝试的强制转换无效。

字符串格式无效。

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

有关详细信息,请参阅 XmlReader 参考页和 W3C XML 架构第 2 部分:数据类型 建议。

适用于