WebClient.DownloadDataTaskAsync 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 como um Byte array a partir do URI especificado como uma operação assíncrona usando um objeto tarefa. Estes métodos não bloqueiam o fio que chama.
Sobrecargas
| Name | Description |
|---|---|
| DownloadDataTaskAsync(String) |
Descarrega o recurso como um Byte array a partir do URI especificado como uma operação assíncrona usando um objeto tarefa. |
| DownloadDataTaskAsync(Uri) |
Descarrega o recurso como um Byte array a partir do URI especificado como uma operação assíncrona usando um objeto tarefa. |
DownloadDataTaskAsync(String)
Descarrega o recurso como um Byte array a partir do URI especificado como uma operação assíncrona usando um objeto tarefa.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(string address);public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(string address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>Public Function DownloadDataTaskAsync (address As String) As Task(Of Byte())Parâmetros
- address
- String
O URI do recurso a descarregar.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um Byte array contendo o recurso descarregado.
- Atributos
Exceções
O address parâmetro é null.
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.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído após o download do recurso de dados.
Este método recupera o recurso especificado usando o método padrão para o protocolo associado ao esquema URI especificado no address parâmetro. Os dados são descarregados de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads.
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.
O exemplo de código seguinte solicita dados a um servidor e apresenta os dados devolvidos. Assume que contém remoteUri um URI válido para os dados solicitados.
Aplica-se a
DownloadDataTaskAsync(Uri)
Descarrega o recurso como um Byte array a partir do URI especificado como uma operação assíncrona usando um objeto tarefa.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(Uri address);public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(Uri address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())Parâmetros
- address
- Uri
O URI do recurso a descarregar.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um Byte array contendo o recurso descarregado.
- Atributos
Exceções
O address parâmetro é null.
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.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído após o download do recurso de dados.
Este método recupera o recurso especificado usando o método padrão para o protocolo associado ao esquema URI especificado no address parâmetro. Os dados são descarregados de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads.
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.