XmlReader.ReadContentAsObject 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 do texto na posição atual como um Object.

public:
 virtual System::Object ^ ReadContentAsObject();

public virtual object ReadContentAsObject ();

abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> obj

Public Overridable Function ReadContentAsObject () As Object

Retornos

Object

O conteúdo do texto como o objeto CLR (Common Language Runtime) mais apropriado.

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.

Se o conteúdo for digitado, o leitor retornará um CLR em caixa do tipo mais apropriado, especificado pela ValueType propriedade. Se o conteúdo for um tipo de lista, o leitor retornará uma matriz de objetos em caixa do tipo apropriado.

Observação

Se ocorrer um erro de validação ao analisar o conteúdo e o leitor for um XmlReader objeto criado pelo Create método, o leitor retornará o conteúdo como uma cadeia de caracteres. Em outras palavras, quando ocorre um erro ou aviso de validação, o conteúdo é considerado não tipado.

Se o conteúdo é não tipado, o leitor retorna o conteúdo como uma cadeia de caracteres.

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`	O valor do elemento se o leitor for um leitor de validação de esquema (ValidationType é definido como Schema); caso contrário, 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 ReadContentAsObjectAsync.

Aplica-se a

Partilhar via