XmlReader.ReadElementString Método

Definição

Espaço de Nomes:

System.Xml

Assemblagens:

netstandard.dll, System.Xml.ReaderWriter.dll

Lê os elementos simples apenas de texto. No entanto, recomendamos que utilize este ReadElementContentAsString método, pois oferece uma forma mais direta de lidar com esta operação.

Sobrecargas

Name	Description
ReadElementString()	Lê um elemento apenas de texto. No entanto, recomendamos que utilize este ReadElementContentAsString() método, pois oferece uma forma mais direta de lidar com esta operação.
ReadElementString(String)	Verifica se a Name propriedade do elemento encontrado corresponde à cadeia dada antes de ler um elemento apenas de texto. No entanto, recomendamos que utilize este ReadElementContentAsString() método, pois oferece uma forma mais direta de lidar com esta operação.
ReadElementString(String, String)	Verifica se as LocalName propriedades e NamespaceURI do elemento encontrado correspondem às strings dadas antes de ler um elemento apenas de texto. No entanto, recomendamos que utilize este ReadElementContentAsString(String, String) método, pois oferece uma forma mais direta de lidar com esta operação.

Observações

Recomendamos que utilize o ReadElementContentAsString método para ler um elemento de texto.

ReadElementString()

Origem:

XmlReader.cs

Lê um elemento apenas de texto. No entanto, recomendamos que utilize este ReadElementContentAsString() método, pois oferece uma forma mais direta de lidar com esta 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

Devoluções

String

O texto contido no elemento que foi lido. Uma cadeia vazia se o elemento for vazio.

Exceções

XmlException

O próximo nó de conteúdo não é uma etiqueta inicial; ou o elemento encontrado não contém um valor de texto simples.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Observações

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

ReadElementString(String)

Origem:

XmlReader.cs

Verifica se a Name propriedade do elemento encontrado corresponde à cadeia dada antes de ler um elemento apenas de texto. No entanto, recomendamos que utilize este ReadElementContentAsString() método, pois oferece uma forma mais direta de lidar com esta 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 a verificar.

Devoluções

String

O texto contido no elemento que foi lido. Uma cadeia vazia se o elemento for vazio.

Exceções

XmlException

Se o próximo nó de conteúdo não for uma etiqueta inicial; se o elemento Name não corresponder ao argumento dado; ou se o elemento encontrado não contiver um valor de texto simples.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Observações

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

ReadElementString(String, String)

Origem:

XmlReader.cs

Verifica se as LocalName propriedades e NamespaceURI do elemento encontrado correspondem às strings dadas antes de ler um elemento apenas de texto. No entanto, recomendamos que utilize este ReadElementContentAsString(String, String) método, pois oferece uma forma mais direta de lidar com esta 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 verificar.

ns

String

O URI do namespace para verificar.

Devoluções

String

O texto contido no elemento que foi lido. Uma cadeia vazia se o elemento for vazio.

Exceções

XmlException

Se o próximo nó de conteúdo não for uma etiqueta inicial; se o elemento LocalName ou NamespaceURI não corresponder aos argumentos indicados; ou se o elemento encontrado não contiver um valor de texto simples.

InvalidOperationException

Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."

Observações

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