XmlReader.ReadContentAsString Método

Referência

Definição

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Lê o conteúdo de texto na posição atual como um objeto String.

public:
 virtual System::String ^ ReadContentAsString();

public virtual string ReadContentAsString ();

abstract member ReadContentAsString : unit -> string
override this.ReadContentAsString : unit -> string

Public Overridable Function ReadContentAsString () As String

Retornos

String

O conteúdo de texto como um objeto String.

Exceções

InvalidCastException

A tentativa de conversão não é válida.

FormatException

O formato da cadeia de caracteres não é válido.

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

Esse método concatena texto, espaço em branco, espaço em branco significativo e seções CDATA e ignora quaisquer comentários ou instruções de processamento. As referências de entidade são resolvidas automaticamente.

Esse método pode ser usado para converter valores tipado em uma cadeia de caracteres ou para ler o conteúdo do texto, ignorando comentários e processando instruções.

A tabela a seguir descreve como esse método trata cada tipo de nó.

XmlNodeType	Valor retornado	Comportamento do leitor
`Text` `CDATA` `Whitespace` `SignificantWhitespace` `EntityReference` `EndEntity`	Concatenado conteúdo de texto, de CDATA, de espaço em branco e os nós significativos de espaço em branco convertidos para o tipo solicitado.	Move para a seguir marca de início ou elemento de extremidade. Referências a entidades são automaticamente expandidas.
`Attribute`	O mesmo que chamar `XmlConvert.ToXxx` o valor do atributo.	O leitor permanece na posição atual.
`Comment` `ProcessingInstruction`	Ignora a instrução de processamento (PI) ou o comentário e ler o conteúdo concatenado de texto que segue o PI ou o comentário.	Move para a seguir marca de início ou elemento de extremidade. Referências a entidades são automaticamente expandidas.
`EndElement`	Uma cadeia de caracteres vazia.	O leitor permanece na posição atual.
`Element` `XmlDeclaration` `None` `Document` `DocumentType` `Notation` `Entity` `DocumentFragment`	InvalidOperationException é lançada.	Indefinido, embora geralmente o leitor permaneça na posição atual.

Para obter mais informações, consulte a seção Comentários da página de XmlReader referência e a recomendação W3C XML Schema Part 2: Datatypes .

Para obter a versão assíncrona deste método, consulte ReadContentAsStringAsync.

Aplica-se a

Compartilhar via