WebClient.DownloadStringAsync Método

Definição

Espaço de Nomes:: System.Net

Assemblagem:: System.dll

Assemblagem:: netstandard.dll

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.

Descarrega o recurso especificado como um String ou um Uri. Estes métodos não bloqueiam o fio que chama.

Sobrecargas

Name	Description
DownloadStringAsync(Uri)	Descarrega o recurso especificado como um Uri. Este método não bloqueia o thread que chama.
DownloadStringAsync(Uri, Object)	Descarrega a cadeia especificada para o recurso especificado. Este método não bloqueia o thread que chama.

DownloadStringAsync(Uri)

Descarrega o recurso especificado como um Uri. Este método não bloqueia o thread que chama.

public:
 void DownloadStringAsync(Uri ^ address);

public void DownloadStringAsync(Uri address);

member this.DownloadStringAsync : Uri -> unit

Public Sub DownloadStringAsync (address As Uri)

Parâmetros

address: Uri

A contendo Uri o URI para descarregar.

Exceções

ArgumentNullException

O address parâmetro é null.

WebException

O URI formado pela combinação BaseAddress de e address é inválido.

-ou-

Ocorreu um erro durante o download do recurso.

Observações

Atenção

WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.

O recurso é descarregado de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads.

Após descarregar o recurso, este método utiliza a codificação especificada na Encoding propriedade para converter o recurso num String. Este método não bloqueia o fio de chamada durante o download do recurso. Para descarregar um recurso e bloquear enquanto espera pela resposta do servidor, use o DownloadString método. Quando o download termina, o DownloadStringCompleted evento é elevado. A sua candidatura deve tratar deste evento para receber notificação. A cadeia descarregada está disponível na Result propriedade.

No .NET Framework, pode cancelar operações assíncronas que não tenham sido concluídas chamando o método CancelAsync.

Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não contiver um URI absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é anexada a address.

Este método utiliza o comando RETR para descarregar um recurso FTP. Para um recurso HTTP, utiliza-se o método GET.

Note

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Network Tracing in .NET Framework.

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 DownloadString(Uri).

Aplica-se a

DownloadStringAsync(Uri, Object)

Descarrega a cadeia especificada para o recurso especificado. Este método não bloqueia o thread que chama.

public:
 void DownloadStringAsync(Uri ^ address, System::Object ^ userToken);

public void DownloadStringAsync(Uri address, object userToken);

member this.DownloadStringAsync : Uri * obj -> unit

Public Sub DownloadStringAsync (address As Uri, userToken As Object)