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 .