Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo WebClient.DownloadDataTaskAsync (String)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.Net
Assembly:  System (in System.dll)

[ComVisibleAttribute(false)]
[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public Task<byte[]> DownloadDataTaskAsync(
	string address
)

Parametri

address
Type: System.String

L'URI della risorsa da scaricare.

Valore restituito

Type: System.Threading.Tasks.Task<Byte[]>

Restituisce Task<TResult>.

Oggetto dell'attività che rappresenta l'operazione asincrona. Il Result proprietà nell'oggetto attività restituisce un Byte matrice contenente la risorsa scaricata.

Exception Condition
ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI formato dalla combinazione BaseAddress e address non è valido.

-oppure-

Si è verificato un errore durante il download della risorsa.

Questa operazione non verrà bloccata. L'oggetto restituito Task<TResult> oggetto verrà completato dopo che la risorsa di dati è stata scaricata.

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

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

Questo metodo utilizza il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP viene utilizzato il metodo GET.

System_CAPS_noteNota

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

Esempio di codice seguente richiede i dati da un server e visualizza i dati restituiti. Si presuppone che remoteUri contiene un URI valido per i dati richiesti.

.NET Framework
Disponibile da 4.5
Torna all'inizio
Mostra: