Compartilhar via


XmlReader.ReadContentAsStringAsync Método

Definição

Lê de forma assíncrona o conteúdo do texto na posição atual como um String objeto.

public:
 virtual System::Threading::Tasks::Task<System::String ^> ^ ReadContentAsStringAsync();
public virtual System.Threading.Tasks.Task<string> ReadContentAsStringAsync();
abstract member ReadContentAsStringAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadContentAsStringAsync : unit -> System.Threading.Tasks.Task<string>
Public Overridable Function ReadContentAsStringAsync () As Task(Of String)

Retornos

O conteúdo do texto como um String objeto.

Exceções

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".

- ou -

Um XmlReader método assíncrono foi chamado sem definir o Async sinalizador como true. Nesse caso, InvalidOperationException é gerada com a mensagem "Definir XmlReaderSettings.Async como true se você quiser usar métodos assíncronos".

Comentários

Essa é a versão assíncrona de ReadContentAsString, com a mesma funcionalidade. Para usar esse método, você deve definir o Async sinalizador como true.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por ReadContentAsString().

Aplica-se a

Confira também