XmlReader.ReadElementString Метод

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

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

Перегрузки

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

Комментарии

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

ReadElementString()

Считывает элемент, предназначенный только для чтения. Однако рекомендуем использовать вместо этого метод 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)

Проверяет перед чтением текстового элемента соответствие значения свойства 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)

Проверяет перед чтением текстового элемента соответствие значений свойств 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) метод для чтения текстового элемента.