XmlReader.ReadContentAsObject Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

XmlReader.cs

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

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

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

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

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

Сведения об асинхронной версии этого метода см. в разделе ReadContentAsObjectAsync.