XmlReader.ReadElementString Método

Definição

Lê somente os elementos de texto simples.Reads the simple text-only elements. 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.However, we recommend that you use the ReadElementContentAsString method instead, because it provides a more straightforward way to handle this operation.

Sobrecargas

ReadElementString()

Lê um elemento somente texto.Reads a text-only element. 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.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

ReadElementString(String)

Verifica se a propriedade Name do elemento encontrado corresponde à cadeia de caracteres fornecida antes de ler um elemento somente texto.Checks that the Name property of the element found matches the given string before reading a text-only element. 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.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

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.Checks that the LocalName and NamespaceURI properties of the element found matches the given strings before reading a text-only element. 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.However, we recommend that you use the ReadElementContentAsString(String, String) method instead, because it provides a more straightforward way to handle this operation.

Comentários

Recomendamos que você use o ReadElementContentAsString método para ler um elemento de texto.We recommend that you use the ReadElementContentAsString method to read a text element.

ReadElementString()

Lê um elemento somente texto.Reads a text-only element. 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.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

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.The text contained in the element that was read. Uma cadeia de caracteres vazia se o elemento estiver vazio.An empty string if the element is empty.

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.The next content node is not a start tag; or the element found does not contain a simple text value.

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentários

Recomendamos que você use o ReadElementContentAsString() método para ler um elemento de texto.We recommend that you use the ReadElementContentAsString() method to read a text element.

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.Checks that the Name property of the element found matches the given string before reading a text-only element. 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.However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

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.The name to check.

Retornos

String

O texto contido no elemento que foi lido.The text contained in the element that was read. Uma cadeia de caracteres vazia se o elemento estiver vazio.An empty string if the element is empty.

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.If the next content node is not a start tag; if the element Name does not match the given argument; or if the element found does not contain a simple text value.

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentários

Recomendamos que você use o ReadElementContentAsString() método para ler um elemento de texto.We recommend that you use the ReadElementContentAsString() method to read a text element.

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.Checks that the LocalName and NamespaceURI properties of the element found matches the given strings before reading a text-only element. 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.However, we recommend that you use the ReadElementContentAsString(String, String) method instead, because it provides a more straightforward way to handle this operation.

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.The local name to check.

ns
String

O URI de namespace a ser verificado.The namespace URI to check.

Retornos

String

O texto contido no elemento que foi lido.The text contained in the element that was read. Uma cadeia de caracteres vazia se o elemento estiver vazio.An empty string if the element is empty.

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.If the next content node is not a start tag; if the element LocalName or NamespaceURI do not match the given arguments; or if the element found does not contain a simple text value.

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior.An XmlReader method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentários

Recomendamos que você use o ReadElementContentAsString(String, String) método para ler um elemento de texto.We recommend that you use the ReadElementContentAsString(String, String) method to read a text element.

Aplica-se a