WebClient.DownloadFileTaskAsync Metodo

Definizione

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

Overload

DownloadFileTaskAsync(String, String)

Scarica la risorsa specificata in un file locale come operazione asincrona utilizzando un oggetto attività.Downloads the specified resource to a local file as an asynchronous operation using a task object.

DownloadFileTaskAsync(Uri, String)

Scarica la risorsa specificata in un file locale come operazione asincrona utilizzando un oggetto attività.Downloads the specified resource to a local file as an asynchronous operation using a task object.

DownloadFileTaskAsync(String, String)

Scarica la risorsa specificata in un file locale come operazione asincrona utilizzando un oggetto attività.Downloads the specified resource to a local file as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task ^ DownloadFileTaskAsync(System::String ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);
member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task
Public Function DownloadFileTaskAsync (address As String, fileName As String) As Task

Parametri

address
String

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

fileName
String

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

Restituisce

Task

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation.

Attributi

Eccezioni

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

-oppure--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.

-oppure--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

Questa operazione non verrà bloccata.This operation will not block. L' Task oggetto restituito viene completato dopo il download della risorsa dati.The returned Task object will complete after the data resource has been downloaded.

Questo metodo Scarica la risorsa in corrispondenza dell'URI specificato da 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 usando 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.

In .NET Framework e .NET Core 1,0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il CancelAsync metodo.In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

Se la BaseAddress proprietà non è una stringa vuota ("") e non address specifica un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per 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 la QueryString proprietà non è una stringa vuota, viene aggiunta 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 FTP.This method uses the RETR command to download an FTP resource. Per una risorsa HTTP, viene usato 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 ulteriori informazioni, vedere la pagina relativa alla traccia di rete in .NET Framework.For more information, see Network Tracing in .NET Framework.

Quando si usa questo metodo in una pagina ASP.NET, viene visualizzato un errore se l'account in cui viene eseguita la pagina 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

DownloadFileTaskAsync(Uri, String)

Scarica la risorsa specificata in un file locale come operazione asincrona utilizzando un oggetto attività.Downloads the specified resource to a local file as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task ^ DownloadFileTaskAsync(Uri ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);
member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task
Public Function DownloadFileTaskAsync (address As Uri, fileName As String) As Task

Parametri

address
Uri

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

fileName
String

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

Restituisce

Task

Oggetto dell'attività che rappresenta l'operazione asincrona.The task object representing the asynchronous operation.

Attributi

Eccezioni

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

-oppure--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.

-oppure--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

Questa operazione non verrà bloccata.This operation will not block. L' Task oggetto restituito viene completato dopo il download della risorsa dati.The returned Task object will complete after the data resource has been downloaded.

Questo metodo Scarica la risorsa in corrispondenza dell'URI specificato da 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 usando 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.

In .NET Framework e .NET Core 1,0 è possibile annullare le operazioni asincrone che non sono state completate chiamando il CancelAsync metodo.In .NET Framework and .NET Core 1.0, you can cancel asynchronous operations that have not completed by calling the CancelAsync method.

Se la BaseAddress proprietà non è una stringa vuota ("") e non address specifica un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per 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 la QueryString proprietà non è una stringa vuota, viene aggiunta 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 FTP.This method uses the RETR command to download an FTP resource. Per una risorsa HTTP, viene usato 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 ulteriori informazioni, vedere la pagina relativa alla traccia di rete in .NET Framework.For more information, see Network Tracing in .NET Framework.

Quando si usa questo metodo in una pagina ASP.NET, viene visualizzato un errore se l'account in cui viene eseguita la pagina 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