XmlReader.ReadContentAsString 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 String objeto.
public:
virtual System::String ^ ReadContentAsString();public virtual string ReadContentAsString();abstract member ReadContentAsString : unit -> string
override this.ReadContentAsString : unit -> stringPublic Overridable Function ReadContentAsString () As StringDevoluções
O conteúdo do texto como um String objeto.
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.
Este método pode ser usado para converter valores digitados numa cadeia de caracteres, ou para ler o conteúdo do texto saltando comentários e processando instruções.
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 |
Uma cadeia de caracteres 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 ReadContentAsStringAsync.
