XmlReader.ReadElementString Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Lê somente os elementos de texto simples. No entanto, é recomendável que você use o método ReadElementContentAsString em vez disso, porque ele fornece uma maneira mais simples de lidar com essa operação.

Sobrecargas

ReadElementString()	Lê um elemento somente texto. No entanto, é recomendável que você use o método ReadElementContentAsString() em vez disso, porque ele fornece uma maneira mais simples de lidar com essa operação.
ReadElementString(String)	Verifica se a propriedade Name do elemento encontrado corresponde à cadeia de caracteres fornecida antes de ler um elemento somente texto. No entanto, é recomendável que você use o método ReadElementContentAsString() em vez disso, porque ele fornece uma maneira mais simples de lidar com essa operação.
ReadElementString(String, String)	Verifica se as propriedades LocalName e NamespaceURI do elemento encontrado correspondem às cadeias de caracteres fornecidas antes de ler um elemento somente de texto. No entanto, é recomendável que você use o método ReadElementContentAsString(String, String) em vez disso, porque ele fornece uma maneira mais simples de lidar com essa operação.

Comentários

Recomendamos que você use o ReadElementContentAsString método para ler um elemento de texto.

ReadElementString()

Lê um elemento somente texto. No entanto, é recomendável que você use o método ReadElementContentAsString() em vez disso, porque ele fornece uma maneira mais simples de lidar com essa operação.

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

Retornos

String

O texto contido no elemento que foi lido. Uma cadeia de caracteres vazia se o elemento estiver vazio.

Exceções

XmlException

O próximo nó de conteúdo não é uma marca de início ou o elemento encontrado não contém um valor de texto simples.

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Comentários

Recomendamos que você use o ReadElementContentAsString() método para ler um elemento de texto.

ReadElementString(String)

Verifica se a propriedade Name do elemento encontrado corresponde à cadeia de caracteres fornecida antes de ler um elemento somente texto. No entanto, é recomendável que você use o método ReadElementContentAsString() em vez disso, porque ele fornece uma maneira mais simples de lidar com essa operação.

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

Parâmetros

name

String

O nome para verificar.

Retornos

String

O texto contido no elemento que foi lido. Uma cadeia de caracteres vazia se o elemento estiver vazio.

Exceções

XmlException

Se o próximo nó de conteúdo não for uma marca de início; se o elemento Name não corresponde ao argumento fornecido; ou se o elemento encontrado não contiver um valor de texto simples.

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Comentários

Recomendamos que você use o ReadElementContentAsString() método para ler um elemento de texto.

ReadElementString(String, String)

Verifica se as propriedades LocalName e NamespaceURI do elemento encontrado correspondem às cadeias de caracteres fornecidas antes de ler um elemento somente de texto. No entanto, é recomendável que você use o método ReadElementContentAsString(String, String) em vez disso, porque ele fornece uma maneira mais simples de lidar com essa operação.

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

Parâmetros

localname

String

O nome local a ser verificado.

ns

String

O URI de namespace a ser verificado.

Retornos

String

O texto contido no elemento que foi lido. Uma cadeia de caracteres vazia se o elemento estiver vazio.

Exceções

XmlException

Se o próximo nó de conteúdo não for uma marca de início; se o elemento LocalName ou NamespaceURI não corresponder aos argumentos fornecidos; ou se o elemento encontrado não contiver um valor de texto simples.

InvalidOperationException

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Comentários

Recomendamos que você use o ReadElementContentAsString(String, String) método para ler um elemento de texto.