XmlReader.ReadElementContentAsDateTime 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

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

重载

ReadElementContentAsDateTime()	读取当前元素并将内容作为 DateTime 对象返回。
ReadElementContentAsDateTime(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 DateTime 对象返回。

ReadElementContentAsDateTime()

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

public:
 virtual DateTime ReadElementContentAsDateTime();

public virtual DateTime ReadElementContentAsDateTime ();

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

Public Overridable Function ReadElementContentAsDateTime () As DateTime

返回

DateTime

作为 DateTime 对象的元素内容。

例外

InvalidOperationException

XmlReader 未定位在元素上。

• 或 -

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

XmlException

当前元素包含子元素。

• 或 -

无法将元素内容转换为 DateTime 对象。

ArgumentNullException

使用 null 参数调用此方法。

示例

以下示例使用 ReadElementContentAsDateTime 该方法读取元素的内容 date 。

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = reader.ReadElementContentAsDateTime();
  
     // If the current culture is "en-US",
     // this writes "Wednesday, January 8, 2003".
     Console.WriteLine(date.ToLongDateString());
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = reader.ReadElementContentAsDateTime()
            
  ' If the current culture is "en-US",
  ' this writes "Wednesday, January 8, 2003".
  Console.WriteLine([date].ToLongDateString())
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:dateTime内容，则读取器将返回未装箱 DateTime 的对象。 如果未键入xsd:dateTime内容，则读取器会根据 W3C XML 架构第 2 部分：数据类型建议定义的规则将其DateTime转换为对象。

备注

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

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

ReadElementContentAsDateTime(String, String)

检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 DateTime 对象返回。

public:
 virtual DateTime ReadElementContentAsDateTime(System::String ^ localName, System::String ^ namespaceURI);

public virtual DateTime ReadElementContentAsDateTime (string localName, string namespaceURI);

abstract member ReadElementContentAsDateTime : string * string -> DateTime
override this.ReadElementContentAsDateTime : string * string -> DateTime

Public Overridable Function ReadElementContentAsDateTime (localName As String, namespaceURI As String) As DateTime

参数

localName

String

元素的本地名称。

namespaceURI

String

元素的命名空间 URI。

返回

DateTime

作为 DateTime 对象的元素内容。

例外

InvalidOperationException

XmlReader 未定位在元素上。

• 或 -

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

XmlException

当前元素包含子元素。

• 或 -

无法将元素内容转换成请求的类型。

ArgumentNullException

使用 null 参数调用此方法。

ArgumentException

指定的本地名称和命名空间 URI 与所读取的当前元素的本地名称和命名空间 URI 不匹配。

注解

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

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

备注

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

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