WebClient.DownloadFileAsync 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.
Descarrega o recurso especificado para um ficheiro local como uma operação assíncrona. Estes métodos não bloqueiam o fio que chama.
Sobrecargas
| Name | Description |
|---|---|
| DownloadFileAsync(Uri, String) |
Descarrega, para um ficheiro local, o recurso com o URI especificado. Este método não bloqueia o thread que chama. |
| DownloadFileAsync(Uri, String, Object) |
Descarrega, para um ficheiro local, o recurso com o URI especificado. Este método não bloqueia o thread que chama. |
DownloadFileAsync(Uri, String)
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Descarrega, para um ficheiro local, o recurso com o URI especificado. Este método não bloqueia o thread que chama.
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName);public void DownloadFileAsync(Uri address, string fileName);member this.DownloadFileAsync : Uri * string -> unitPublic Sub DownloadFileAsync (address As Uri, fileName As String)Parâmetros
- address
- Uri
O URI do recurso a descarregar.
- fileName
- String
O nome do ficheiro a ser colocado no computador local.
Exceções
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
Ocorreu um erro durante o download do recurso.
O ficheiro local especificado por fileName está em uso por outro thread.
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.
Este método descarrega o recurso no URI especificado por no address parâmetro. Quando o download é concluído com sucesso, o ficheiro descarregado é nomeado fileName no computador local. O ficheiro é descarregado de forma assíncrona usando recursos de threads que são automaticamente alocados a partir do pool de threads. Para receber notificações quando o ficheiro estiver disponível, adicione um gestor de eventos ao DownloadFileCompleted evento.
Este método não bloqueia o thread que chama enquanto o recurso está a ser descarregado. Para bloquear enquanto espera que o download termine, use um dos DownloadFile métodos.
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 especificar 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.
Ao usar este método numa página ASP.NET, receberá um erro se a conta sob a qual a página é executada não tiver permissão para aceder ao ficheiro local.
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 DownloadFile(Uri, String).
Aplica-se a
DownloadFileAsync(Uri, String, Object)
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Descarrega, para um ficheiro local, o recurso com o URI especificado. Este método não bloqueia o thread que chama.
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName, System::Object ^ userToken);public void DownloadFileAsync(Uri address, string fileName, object? userToken);public void DownloadFileAsync(Uri address, string fileName, object userToken);member this.DownloadFileAsync : Uri * string * obj -> unitPublic Sub DownloadFileAsync (address As Uri, fileName As String, userToken As Object)Parâmetros
- address
- Uri
O URI do recurso a descarregar.
- fileName
- String
O nome do ficheiro a ser colocado no computador local.
- userToken
- Object
Um objeto definido pelo utilizador que é passado para o método invocado quando a operação assíncrona termina.
Exceções
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
Ocorreu um erro durante o download do recurso.
O ficheiro local especificado por fileName está em uso por outro thread.
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.
Este método descarrega o recurso no URI especificado por no address parâmetro. Quando o download é concluído com sucesso, o ficheiro descarregado é nomeado fileName no computador local. O ficheiro é descarregado de forma assíncrona usando recursos de threads que são automaticamente alocados a partir do pool de threads. Para receber notificações quando o ficheiro estiver disponível, adicione um gestor de eventos ao DownloadFileCompleted evento.
Este método não bloqueia o thread que chama enquanto o recurso está a ser descarregado. Para bloquear enquanto espera que o download termine, use um dos DownloadFile métodos.
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 especificar 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.
Ao usar este método numa página ASP.NET, receberá um erro se a conta sob a qual a página é executada não tiver permissão para aceder ao ficheiro local.
