WebClient.DownloadDataTaskAsync Método
Definição
Baixa o recurso como uma matriz Byte do URI especificado como uma operação assíncrona usando um objeto de tarefa.Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object. Esses métodos não bloqueiam o thread de chamada.These methods do not block the calling thread.
Sobrecargas
| DownloadDataTaskAsync(String) |
Baixa o recurso como uma matriz Byte do URI especificado como uma operação assíncrona usando um objeto de tarefa.Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object. |
| DownloadDataTaskAsync(Uri) |
Baixa o recurso como uma matriz Byte do URI especificado como uma operação assíncrona usando um objeto de tarefa.Downloads the resource as a Byte array from the URI specified as an asynchronous operation using a task object. |
DownloadDataTaskAsync(String)
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);
member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
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 ser baixado.The URI of the resource to download.
Retornos
O objeto de tarefa que representa a operação assíncrona.The task object representing the asynchronous operation. A propriedade Result no objeto de tarefa retorna uma matriz Byte que contém o recurso baixado.The Result property on the task object returns a Byte array containing the downloaded resource.
- Atributos
Exceções
O parâmetro address é null.The address parameter is null.
O URI formado pela combinação de BaseAddress e address é inválido.The URI formed by combining BaseAddress and address is invalid.
- ou --or-
Ocorreu um erro ao baixar o recurso.An error occurred while downloading the resource.
Comentários
Esta operação não será bloqueada.This operation will not block. O Task<TResult> objeto retornado será concluído após o download do recurso de dados.The returned Task<TResult> object will complete after the data resource has been downloaded.
Esse método recupera o recurso especificado usando o método padrão para o protocolo associado ao esquema de URI especificado no address parâmetro.This method retrieves the specified resource using the default method for the protocol associated with the URI scheme specified in the address parameter. Os dados são baixados de forma assíncrona usando recursos de thread que são alocados automaticamente do pool de threads.The data is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e não address contiver um URI absoluto, address deverá ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto dos dados solicitados.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será anexada address .If the QueryString property is not an empty string, it is appended to address.
Esse método usa o comando RETR para baixar um recurso de FTP.This method uses the RETR command to download an FTP resource. Para um recurso HTTP, o método GET é usado.For an HTTP resource, the GET method is used.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede em .NET Framework.For more information, see Network Tracing in .NET Framework.
O exemplo de código a seguir solicita dados de um servidor e exibe os dados retornados.The following code example requests data from a server and displays the data returned. Ele pressupõe que remoteUri contém um URI válido para os dados solicitados.It assumes that remoteUri contains a valid URI for the requested data.
Aplica-se a
DownloadDataTaskAsync(Uri)
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
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 ser baixado.The URI of the resource to download.
Retornos
O objeto de tarefa que representa a operação assíncrona.The task object representing the asynchronous operation. A propriedade Result no objeto de tarefa retorna uma matriz Byte que contém o recurso baixado.The Result property on the task object returns a Byte array containing the downloaded resource.
- Atributos
Exceções
O parâmetro address é null.The address parameter is null.
O URI formado pela combinação de BaseAddress e address é inválido.The URI formed by combining BaseAddress and address is invalid.
- ou --or-
Ocorreu um erro ao baixar o recurso.An error occurred while downloading the resource.
Comentários
Esta operação não será bloqueada.This operation will not block. O Task<TResult> objeto retornado será concluído após o download do recurso de dados.The returned Task<TResult> object will complete after the data resource has been downloaded.
Esse método recupera o recurso especificado usando o método padrão para o protocolo associado ao esquema de URI especificado no address parâmetro.This method retrieves the specified resource using the default method for the protocol associated with the URI scheme specified in the address parameter. Os dados são baixados de forma assíncrona usando recursos de thread que são alocados automaticamente do pool de threads.The data is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e não address contiver um URI absoluto, address deverá ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto dos dados solicitados.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será anexada address .If the QueryString property is not an empty string, it is appended to address.
Esse método usa o comando RETR para baixar um recurso de FTP.This method uses the RETR command to download an FTP resource. Para um recurso HTTP, o método GET é usado.For an HTTP resource, the GET method is used.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.This member outputs trace information when you enable network tracing in your application. Para obter mais informações, consulte rastreamento de rede em .NET Framework.For more information, see Network Tracing in .NET Framework.