XmlReader.ReadContentAsString Метод

Определение

Считывает содержимое текста в текущем положении как объект String.

public:
 virtual System::String ^ ReadContentAsString();
public virtual string ReadContentAsString ();
abstract member ReadContentAsString : unit -> string
override this.ReadContentAsString : unit -> string
Public Overridable Function ReadContentAsString () As String

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

String

Текстовое содержимое в виде объекта String.

Исключения

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

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

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

Комментарии

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

Этот метод может использоваться для преобразования типизированных значений в строку или для чтения текстового содержимого при пропуске комментариев и инструкций по обработке.

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

Тип узла 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-схеме часть 2: типы данных.

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

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