Бөлісу құралы:


XmlReader.ReadContentAsObject Метод

Определение

Считывает содержимое текста в текущей позиции как значение Object.

public:
 virtual System::Object ^ ReadContentAsObject();
public virtual object ReadContentAsObject ();
abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> obj
Public Overridable Function ReadContentAsObject () As Object

Возвращаемое значение

Object

Текстовое содержимое как самый подходящий объект CLR.

Исключения

Недопустимая попытка приведения.

Недопустимый формат строки.

Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

Комментарии

Этот метод объединяет текст, пробелы, значительные пробелы и разделы CDATA и пропускает комментарии или инструкции по обработке. Ссылки на сущности разрешаются автоматически.

Если содержимое введено, средство чтения возвращает упаковаемый clR наиболее подходящего типа, указанного свойством ValueType . Если содержимое является типом списка, средство чтения возвращает массив прямоугольных объектов соответствующего типа.

Примечание

Если при анализе содержимого возникает ошибка проверки, а средство чтения является XmlReader объектом, созданным методом Create , средство чтения возвращает содержимое в виде строки. Другими словами, при возникновении ошибки проверки или предупреждения содержимое считается нетипизированным.

Если содержимое не типизировано, средство чтения возвращает его в виде строки.

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

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

CDATA

Whitespace

SignificantWhitespace

EntityReference

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

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

XmlDeclaration

None

Document

DocumentType

Notation

Entity

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

Дополнительные сведения см. в разделе "Примечания" эталонной XmlReader страницы и рекомендации по xml-схеме W3C, часть 2. Рекомендации по типам данных .

Асинхронную версию этого метода см. в разделе ReadContentAsObjectAsync.

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