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.DownloadFileTaskAsync (String, String)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Scarica la risorsa specificata in un file locale come un'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 DownloadFileTaskAsync(
	string address,
	string fileName
)

Parametri

address
Type: System.String

L'URI della risorsa da scaricare.

fileName
Type: System.String

Il nome del file da inserire nel computer locale.

Valore restituito

Type: System.Threading.Tasks.Task

Restituisce Task.

Oggetto dell'attività che rappresenta l'operazione asincrona.

Exception Condition
ArgumentNullException

Il valore del parametro address è null.

-oppure-

Il valore del parametro fileName è null.

WebException

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

-oppure-

Si è verificato un errore durante il download della risorsa.

InvalidOperationException

Il file locale specificato da fileName è utilizzato da un altro thread.

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

La risorsa nell'URI specificato dal download di questo metodo il address parametro. Quando viene completato il download, il file scaricato viene denominato fileName nel computer locale. Il file viene scaricato in modo asincrono utilizzando le risorse thread allocate automaticamente dal pool di thread.

È possibile utilizzare il CancelAsync metodo per annullare operazioni asincrone che non sono state completate.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non specifica 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.

Quando si utilizza questo metodo in una pagina ASP.NET, si riceverà un errore se l'account che la pagina viene eseguita in non dispone dell'autorizzazione per accedere al file locale.

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