WebClient.DownloadFileAsync WebClient.DownloadFileAsync WebClient.DownloadFileAsync WebClient.DownloadFileAsync Method

Definizione

Scarica la risorsa specificata in un file locale come operazione asincrona e restituisce un oggetto attività.Downloads the specified resource to a local file as an asynchronous operation and returns a task object. Questi metodi non bloccano il thread chiamante.These methods do not block the calling thread.

Overload

DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String)

Esegue il download, su un file locale, della risorsa con l'URI specificato.Downloads, to a local file, the resource with the specified URI. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object)

Esegue il download, su un file locale, della risorsa con l'URI specificato.Downloads, to a local file, the resource with the specified URI. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String) DownloadFileAsync(Uri, String)

Esegue il download, su un file locale, della risorsa con l'URI specificato.Downloads, to a local file, the resource with the specified URI. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

public:
 void DownloadFileAsync(Uri ^ address, System::String ^ fileName);
public void DownloadFileAsync (Uri address, string fileName);
member this.DownloadFileAsync : Uri * string -> unit
Public Sub DownloadFileAsync (address As Uri, fileName As String)

Parametri

address
Uri Uri Uri Uri

L'URI della risorsa di cui eseguire il download.The URI of the resource to download.

fileName
String String String String

Il nome del file da posizionare nel computer locale.The name of the file to be placed on the local computer.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro fileName è null.The fileName parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

In alternativa-or- Si è verificato un errore durante il download della risorsa.An error occurred while downloading the resource.

Il file locale specificato da fileName è utilizzato da un altro thread.The local file specified by fileName is in use by another thread.

Commenti

Questo metodo scarica la risorsa nell'URI specificato nel address parametro.This method downloads the resource at the URI specified by in the address parameter. Quando il download viene completato correttamente, il file scaricato viene denominato fileName nel computer locale.When the download completes successfully, the downloaded file is named fileName on the local computer. Il file viene scaricato in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The file is downloaded asynchronously using thread resources that are automatically allocated from the thread pool. Per ricevere notifica quando il file è disponibile, aggiungere un gestore eventi per il DownloadFileCompleted evento.To receive notification when the file is available, add an event handler to the DownloadFileCompleted event.

Questo metodo non blocca il thread chiamante mentre viene scaricata la risorsa.This method does not block the calling thread while the resource is being downloaded. Per bloccare durante l'attesa del completamento del download, usare uno del DownloadFile metodi.To block while waiting for the download to complete, use one of the DownloadFile methods.

È possibile usare il CancelAsync metodo per annullare operazioni asincrone che non sono state completate.You can use the CancelAsync method to cancel asynchronous operations that have not completed.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non specifica un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not specify an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Questo metodo Usa il comando RETR per scaricare una risorsa di FTP.This method uses the RETR command to download an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo GET.For an HTTP resource, the GET method is used.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Quando si usa 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.When using this method in an ASP.NET page, you will receive an error if the account that the page executes under does not have permission to access the local file.

DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object) DownloadFileAsync(Uri, String, Object)

Esegue il download, su un file locale, della risorsa con l'URI specificato.Downloads, to a local file, the resource with the specified URI. Questo metodo non blocca il thread chiamante.This method does not block the calling thread.

public:
 void DownloadFileAsync(Uri ^ address, System::String ^ fileName, System::Object ^ userToken);
public void DownloadFileAsync (Uri address, string fileName, object userToken);
member this.DownloadFileAsync : Uri * string * obj -> unit
Public Sub DownloadFileAsync (address As Uri, fileName As String, userToken As Object)

Parametri

address
Uri Uri Uri Uri

L'URI della risorsa di cui eseguire il download.The URI of the resource to download.

fileName
String String String String

Il nome del file da posizionare nel computer locale.The name of the file to be placed on the local computer.

userToken
Object Object Object Object

Oggetto definito dall'utente passato al metodo richiamato al completamento dell'operazione asincrona.A user-defined object that is passed to the method invoked when the asynchronous operation completes.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro fileName è null.The fileName parameter is null.

L'URI ottenuto combinando BaseAddress e address non è valido.The URI formed by combining BaseAddress and address is invalid.

In alternativa-or- Si è verificato un errore durante il download della risorsa.An error occurred while downloading the resource.

Il file locale specificato da fileName è utilizzato da un altro thread.The local file specified by fileName is in use by another thread.

Commenti

Questo metodo scarica la risorsa nell'URI specificato nel address parametro.This method downloads the resource at the URI specified by in the address parameter. Quando il download viene completato correttamente, il file scaricato viene denominato fileName nel computer locale.When the download completes successfully, the downloaded file is named fileName on the local computer. Il file viene scaricato in modo asincrono utilizzando le risorse del thread allocate automaticamente dal pool di thread.The file is downloaded asynchronously using thread resources that are automatically allocated from the thread pool. Per ricevere notifica quando il file è disponibile, aggiungere un gestore eventi per il DownloadFileCompleted evento.To receive notification when the file is available, add an event handler to the DownloadFileCompleted event.

Questo metodo non blocca il thread chiamante mentre viene scaricata la risorsa.This method does not block the calling thread while the resource is being downloaded. Per bloccare durante l'attesa del completamento del download, usare uno del DownloadFile metodi.To block while waiting for the download to complete, use one of the DownloadFile methods.

È possibile usare il CancelAsync metodo per annullare operazioni asincrone che non sono state completate.You can use the CancelAsync method to cancel asynchronous operations that have not completed.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non specifica un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not specify an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Questo metodo Usa il comando RETR per scaricare una risorsa di FTP.This method uses the RETR command to download an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo GET.For an HTTP resource, the GET method is used.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Quando si usa 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.When using this method in an ASP.NET page, you will receive an error if the account that the page executes under does not have permission to access the local file.

Si applica a