XmlReader.ReadContentAsDateTime Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, 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 объект в соответствии с правилами, определенными в рекомендации по схеме XML W3C 2.

Note

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

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

XmlNodeType	Возвращаемое значение	Поведение читателя
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Сцепленное содержимое текста, CDATA, пробелов и значительных узлов пробелов, преобразованных в запрошенный тип.	Перемещается к следующему начальном элементу или тегу конечного элемента. Ссылки на сущности автоматически расширяются.
Attribute	Аналогично вызову XmlConvert.ToXxx значения атрибута.	Средство чтения остается в текущей позиции.
Comment ProcessingInstruction	Игнорирует инструкцию обработки (PI) или комментарий и считывает сцепленное текстовое содержимое, следующее за идентификатором или комментарием.	Перемещается к следующему начальном элементу или тегу конечного элемента. Ссылки на сущности автоматически расширяются.
EndElement	Пустая строка.	Средство чтения остается в текущей позиции.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Вызывается InvalidOperationException .	Не определено, хотя обычно читатель остается в текущей позиции.

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