XmlReader.ReadContentAsString Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

XmlReader.cs

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

Исключения

InvalidCastException

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

FormatException

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

InvalidOperationException

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

Комментарии

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

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

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

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.

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