WebClient.DownloadDataTaskAsync Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebClient.dll

Scarica la risorsa come matrice Byte dall'URI specificato come operazione asincrona utilizzando un oggetto attività. Questi metodi non bloccano il thread chiamante.

Overload

DownloadDataTaskAsync(String)	Scarica la risorsa come matrice Byte dall'URI specificato come operazione asincrona utilizzando un oggetto attività.
DownloadDataTaskAsync(Uri)	Scarica la risorsa come matrice Byte dall'URI specificato come operazione asincrona utilizzando un oggetto attività.

DownloadDataTaskAsync(String)

Origine:

WebClient.cs

Scarica la risorsa come matrice Byte dall'URI specificato come operazione asincrona utilizzando un oggetto attività.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);

member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>

Public Function DownloadDataTaskAsync (address As String) As Task(Of Byte())

Parametri

address

String

L'URI della risorsa di cui eseguire il download.

Restituisce

Task<Byte[]>

Oggetto dell'attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce una matrice Byte che contiene la risorsa scaricata.

Eccezioni

ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI ottenuto combinando BaseAddress e address non è valido.

-oppure-

Si è verificato un errore durante il download della risorsa.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo il download della risorsa dati.

Questo metodo recupera la risorsa specificata utilizzando il metodo predefinito per il protocollo associato allo schema URI specificato nel address parametro . I dati vengono scaricati in modo asincrono usando risorse thread allocate automaticamente dal pool di thread.

Se la BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la QueryString proprietà non è una stringa vuota, viene aggiunta a address.

Questo metodo usa il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo GET.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Nell'esempio di codice seguente vengono richieste dati da un server e vengono visualizzati i dati restituiti. Presuppone che remoteUri contenga un URI valido per i dati richiesti.

DownloadDataTaskAsync(Uri)

Origine:

WebClient.cs

Scarica la risorsa come matrice Byte dall'URI specificato come operazione asincrona utilizzando un oggetto attività.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);

member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>

Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())

Parametri

address

Uri

L'URI della risorsa di cui eseguire il download.

Restituisce

Task<Byte[]>

Oggetto dell'attività che rappresenta l'operazione asincrona. La proprietà Result nell'oggetto attività restituisce una matrice Byte che contiene la risorsa scaricata.

Eccezioni

ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI ottenuto combinando BaseAddress e address non è valido.

-oppure-

Si è verificato un errore durante il download della risorsa.

Commenti

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> verrà completato dopo il download della risorsa dati.

Questo metodo recupera la risorsa specificata utilizzando il metodo predefinito per il protocollo associato allo schema URI specificato nel address parametro . I dati vengono scaricati in modo asincrono usando risorse thread allocate automaticamente dal pool di thread.

Se la BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la QueryString proprietà non è una stringa vuota, viene aggiunta a address.

Questo metodo usa il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo GET.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.