XmlReader.ReadContentAsString Метод

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

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

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

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

Тип узла XML	Возвращаемое значение	Поведение модуля чтения
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Объединенное содержимое узлов текста, CDATA, пробелов и значимых пробелов, преобразованное в необходимый тип.	Перемещается к следующему тегу начального или конечного элемента. Ссылки на сущности автоматически раскрываются.
Attribute	Аналогично вызову XmlConvert.ToXxx значения атрибута.	Средство чтения остается в текущей позиции.
Comment ProcessingInstruction	Пропускает инструкцию по обработке или комментарий и считывает объединенное текстовое содержимое, следующее за инструкцией по обработке или комментарием.	Перемещается к следующему тегу начального или конечного элемента. Ссылки на сущности автоматически раскрываются.
EndElement	Пустая строка.	Средство чтения остается в текущей позиции.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Возникает исключение InvalidOperationException.	Не определено, хотя обычно модуль чтения остается в текущей позиции.

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

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