XmlReader.ReadContentAsObject Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 ObjectDevoluções
O conteúdo do texto como o objeto de execução de linguagem comum (CLR) mais apropriado.
Exceções
A tentativa de lançamento não é válida.
O formato da string não é válido.
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
Este método concatena texto, espaços em branco, espaços em branco significativos e secções CDATA, e ignora quaisquer comentários ou instruções de processamento. As referências às entidades são resolvidas automaticamente.
Se o conteúdo for digitado, o leitor devolve um CLR em caixa do tipo mais apropriado, especificado pela ValueType propriedade. Se o conteúdo for um tipo de lista, o leitor devolve um array de objetos em caixa do tipo apropriado.
Note
Se ocorrer um erro de validação durante a análise do conteúdo e o leitor for um XmlReader objeto criado pelo Create método, o leitor devolve o conteúdo como uma cadeia. Por outras palavras, quando ocorre um erro ou aviso de validação, o conteúdo é considerado não tipado.
Se o conteúdo não for digitado, o leitor devolve o conteúdo como uma cadeia.
A tabela seguinte descreve como este método trata cada tipo de nó.
| XmlNodeType | Valor de retorno | Comportamento do leitor |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
Conteúdo concatenado de texto, CDATA, espaços em branco e nós significativos de espaço em branco convertidos para o tipo solicitado. | Move-se para o próximo elemento inicial ou etiqueta de elemento final. As referências de entidades são automaticamente expandidas. |
Attribute |
É o mesmo que invocar XmlConvert.ToXxx o valor do atributo. |
O leitor mantém-se na posição atual |
CommentProcessingInstruction |
Ignora a instrução de processamento (PI) ou comentário e lê o texto concatenado que segue o PI ou comentário. | Move-se para o próximo elemento inicial ou etiqueta de elemento final. As referências de entidades são automaticamente expandidas. |
EndElement |
O valor do elemento se o leitor for um leitor de validação de esquemas (ValidationType é definido para Schema); caso contrário, uma cadeia vazia. | O leitor mantém-se na posição atual. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
Um InvalidOperationException é jogado. | Indefinido, embora normalmente o leitor permaneça na posição atual. |
Para mais informações, consulte a secção Observações da XmlReader página de referência e a recomendação do Esquema XML do W3C Parte 2: Tipos de dados .
Para a versão assíncrona deste método, veja ReadContentAsObjectAsync.
