XmlReader.ReadContentAsObject Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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.