XmlReader.ReadElementString Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Считывает простые элементы, доступные только для текста. Однако вместо этого рекомендуется использовать ReadElementContentAsString метод, так как он предоставляет более простой способ обработки этой операции.

Перегрузки

Имя	Описание
ReadElementString()	Считывает элемент только для текста. Однако вместо этого рекомендуется использовать ReadElementContentAsString() метод, так как он предоставляет более простой способ обработки этой операции.
ReadElementString(String)	Проверяет, соответствует ли Name свойство элемента заданной строке перед чтением элемента только для текста. Однако вместо этого рекомендуется использовать ReadElementContentAsString() метод, так как он предоставляет более простой способ обработки этой операции.
ReadElementString(String, String)	Проверяет, соответствует ли LocalName найденный элемент и NamespaceURI свойства заданным строкам перед чтением элемента только для текста. Однако вместо этого рекомендуется использовать ReadElementContentAsString(String, String) метод, так как он предоставляет более простой способ обработки этой операции.

Комментарии

Мы рекомендуем использовать ReadElementContentAsString метод для чтения текстового элемента.

ReadElementString()

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

XmlReader.cs

Считывает элемент только для текста. Однако вместо этого рекомендуется использовать ReadElementContentAsString() метод, так как он предоставляет более простой способ обработки этой операции.

public:
 virtual System::String ^ ReadElementString();

public virtual string ReadElementString();

abstract member ReadElementString : unit -> string
override this.ReadElementString : unit -> string

Public Overridable Function ReadElementString () As String

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

String

Текст, содержащийся в элементе, который был прочитан. Пустая строка, если элемент пуст.

Исключения

XmlException

Следующий узел содержимого не является тегом запуска; или найденный элемент не содержит простое текстовое значение.

InvalidOperationException

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

Комментарии

Мы рекомендуем использовать ReadElementContentAsString() метод для чтения текстового элемента.

ReadElementString(String)

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

XmlReader.cs

Проверяет, соответствует ли Name свойство элемента заданной строке перед чтением элемента только для текста. Однако вместо этого рекомендуется использовать ReadElementContentAsString() метод, так как он предоставляет более простой способ обработки этой операции.

public:
 virtual System::String ^ ReadElementString(System::String ^ name);

public virtual string ReadElementString(string name);

abstract member ReadElementString : string -> string
override this.ReadElementString : string -> string

Public Overridable Function ReadElementString (name As String) As String

Параметры

name

String

Имя для проверки.

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

String

Текст, содержащийся в элементе, который был прочитан. Пустая строка, если элемент пуст.

Исключения

XmlException

Если следующий узел содержимого не является тегом запуска; Значение , если элемент не соответствует заданному аргументу; или если найденный элемент Name не содержит простое текстовое значение.

InvalidOperationException

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

Комментарии

Мы рекомендуем использовать ReadElementContentAsString() метод для чтения текстового элемента.

ReadElementString(String, String)

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

XmlReader.cs

Проверяет, соответствует ли LocalName найденный элемент и NamespaceURI свойства заданным строкам перед чтением элемента только для текста. Однако вместо этого рекомендуется использовать ReadElementContentAsString(String, String) метод, так как он предоставляет более простой способ обработки этой операции.

public:
 virtual System::String ^ ReadElementString(System::String ^ localname, System::String ^ ns);

public virtual string ReadElementString(string localname, string ns);

abstract member ReadElementString : string * string -> string
override this.ReadElementString : string * string -> string

Public Overridable Function ReadElementString (localname As String, ns As String) As String

Параметры

localname

String

Локальное имя для проверки.

ns

String

Проверяемого URI пространства имен.

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

String

Текст, содержащийся в элементе, который был прочитан. Пустая строка, если элемент пуст.

Исключения

XmlException

Если следующий узел содержимого не является тегом запуска; Значение , если элемент или LocalName не соответствует заданным аргументам; или если найденный элемент NamespaceURI не содержит простое текстовое значение.

InvalidOperationException

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

Комментарии

Мы рекомендуем использовать ReadElementContentAsString(String, String) метод для чтения текстового элемента.