Поделиться через


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, читатель пытается преобразовать его в DateTime объект в соответствии с правилами, определенными в рекомендации W3C XML Schema Part 2: Datatypes .

Примечание

Не следует полагаться на значение свойства DateTime.Year, когда содержимое типизируется как xsd:gMonthDay. XmlReader в этом случае всегда задает DateTime.Year значение 1904.

В следующей таблице описано, как этот метод обрабатывает каждый тип узла.

Тип узла XML Возвращаемое значение Поведение модуля чтения
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
Объединенное содержимое узлов текста, CDATA, пробелов и значимых пробелов, преобразованное в необходимый тип. Перемещается к следующему тегу начального или конечного элемента. Ссылки на сущности автоматически раскрываются.
Attribute Аналогично вызову XmlConvert.ToXxx значения атрибута. Средство чтения остается в текущей позиции.
Comment

ProcessingInstruction
Пропускает инструкцию по обработке или комментарий и считывает объединенное текстовое содержимое, следующее за инструкцией по обработке или комментарием. Перемещается к следующему тегу начального или конечного элемента. Ссылки на сущности автоматически раскрываются.
EndElement Пустая строка. Средство чтения остается в текущей позиции.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Возникает исключение InvalidOperationException. Не определено, хотя обычно модуль чтения остается в текущей позиции.

Дополнительные сведения см. на странице справочника XmlReader и в рекомендации W3C XML Schema Part 2: Datatypes .

Применяется к