XmlReader.ReadContentAsObject Método
Definição
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 -> objPublic Overridable Function ReadContentAsObject () As ObjectRetornos
O conteúdo do texto como o objeto CLR (Common Language Runtime) mais apropriado.
Exceções
A tentativa de conversão não é válida.
O formato de cadeia de caracteres não é válido.
Um XmlReader método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada com a mensagem "Uma operação assíncrona já está em andamento".
Comentários
Esse método concatena o texto, o espaço em branco, o espaço em branco significativo e as seções CDATA e ignora qualquer comentário 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 de validação ou aviso, o conteúdo é considerado não tipado.
Se o conteúdo não for digitado, o leitor retornará o conteúdo como uma cadeia de caracteres.
A tabela a seguir descreve como esse método trata cada tipo de nó.
| XmlNodeType | Valor de retorno | Comportamento do leitor |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
Conteúdo concatenado de texto, CDATA, espaço em branco e nós de espaço em branco significativos convertidos no tipo solicitado. | Move para o próximo elemento inicial ou marca de elemento final. As referências de entidade são expandidas automaticamente. |
Attribute |
O mesmo que chamar XmlConvert.ToXxx no valor do atributo. |
O leitor permanece na posição atual |
CommentProcessingInstruction |
Ignora a instrução de processamento (PI) ou o comentário e lê o conteúdo de texto concatenado que segue o PI ou o comentário. | Move para o próximo elemento inicial ou marca de elemento final. As referências de entidade são expandidas automaticamente. |
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. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
Um InvalidOperationException é lançado. | Indefinido, embora normalmente 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.
