TextReader.ReadToEndAsync 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.
Sobrecargas
| Name | Description |
|---|---|
| ReadToEndAsync() |
Lê todos os caracteres da posição atual até ao fim do leitor de texto de forma assíncrona e devolve-os como uma única cadeia. |
| ReadToEndAsync(CancellationToken) |
Lê todos os caracteres da posição atual até ao fim do leitor de texto de forma assíncrona e devolve-os como uma única cadeia. |
ReadToEndAsync()
- Origem:
- TextReader.cs
- Origem:
- TextReader.cs
- Origem:
- TextReader.cs
- Origem:
- TextReader.cs
- Origem:
- TextReader.cs
Lê todos os caracteres da posição atual até ao fim do leitor de texto de forma assíncrona e devolve-os como uma única cadeia.
public:
virtual System::Threading::Tasks::Task<System::String ^> ^ ReadToEndAsync();
public virtual System.Threading.Tasks.Task<string> ReadToEndAsync();
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Threading.Tasks.Task<string> ReadToEndAsync();
abstract member ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadToEndAsync : unit -> System.Threading.Tasks.Task<string>
Public Overridable Function ReadToEndAsync () As Task(Of String)
Devoluções
Uma tarefa que representa a operação de leitura assíncrona. O valor do TResult parâmetro contém uma cadeia com os caracteres desde a posição atual até ao final do leitor de texto.
- Atributos
Exceções
O número de caracteres é maior do que o Int32.MaxValue.
O leitor de texto foi descartado.
O leitor está atualmente em uso por uma operação de leitura anterior.
Observações
A TextReader disciplina é uma disciplina abstrata. Portanto, não o instancias no teu código. Para um exemplo de utilização do ReadToEndAsync método, veja o StreamReader.ReadToEndAsync método.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por ReadToEnd().
Ver também
- ReadToEndAsync()
- ReadToEndAsync()
- E/S de arquivo e fluxo
- Como: Ler texto de um arquivo
- Como: Gravar texto em um arquivo
Aplica-se a
ReadToEndAsync(CancellationToken)
- Origem:
- TextReader.cs
- Origem:
- TextReader.cs
- Origem:
- TextReader.cs
- Origem:
- TextReader.cs
- Origem:
- TextReader.cs
Lê todos os caracteres da posição atual até ao fim do leitor de texto de forma assíncrona e devolve-os como uma única cadeia.
public:
virtual System::Threading::Tasks::Task<System::String ^> ^ ReadToEndAsync(System::Threading::CancellationToken cancellationToken);
public virtual System.Threading.Tasks.Task<string> ReadToEndAsync(System.Threading.CancellationToken cancellationToken);
abstract member ReadToEndAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
override this.ReadToEndAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
Public Overridable Function ReadToEndAsync (cancellationToken As CancellationToken) As Task(Of String)
Parâmetros
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento.
Devoluções
Uma tarefa que representa a operação de leitura assíncrona. O valor do TResult parâmetro contém uma cadeia com os caracteres desde a posição atual até ao final do leitor de texto.
Exceções
O número de caracteres é maior do que o Int32.MaxValue.
O leitor de texto foi descartado.
O leitor está atualmente em uso por uma operação de leitura anterior.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
A TextReader disciplina é uma disciplina abstrata. Portanto, não o instancias no teu código. Para um exemplo de utilização do ReadToEndAsync(CancellationToken) método, veja o ReadToEndAsync(CancellationToken) método.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por ReadToEnd().