XmlReader.ReadContentAsDateTime Метод

Определение

Пространство имен:

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Исходный код:

XmlReader.cs

Считывает содержимое текста в текущем положении как объект 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, читатель пытается преобразовать его в 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 .