Partilhar via


XmlReader.ReadElementString Método

Definição

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

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.

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.

Aplica-se a

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

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.

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.

Aplica-se a

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

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.

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.

Aplica-se a