XmlReader.ReadContentAsObject Метод

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

Считывает содержимое текста в текущей позиции как значение 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.

Исключения

InvalidCastException

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

FormatException

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

InvalidOperationException

Метод 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.