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

Définition

Télécharge la ressource spécifiée dans un fichier local en tant qu'opération asynchrone.Downloads the specified resource to a local file as an asynchronous operation. Ces méthodes ne bloquent pas le thread appelant.These methods do not block the calling thread.

Surcharges

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

Télécharge, vers un fichier local, la ressource ayant l'URI spécifié.Downloads, to a local file, the resource with the specified URI. Cette méthode ne bloque pas le thread appelant.This method does not block the calling thread.

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

Télécharge, vers un fichier local, la ressource ayant l'URI spécifié.Downloads, to a local file, the resource with the specified URI. Cette méthode ne bloque pas le thread appelant.This method does not block the calling thread.

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

Télécharge, vers un fichier local, la ressource ayant l'URI spécifié.Downloads, to a local file, the resource with the specified URI. Cette méthode ne bloque pas le thread appelant.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)

Paramètres

address
Uri Uri Uri Uri

URI de la ressource à télécharger.The URI of the resource to download.

fileName
String String String String

Nom du fichier à placer sur l'ordinateur local.The name of the file to be placed on the local computer.

Exceptions

Le paramètre address a la valeur null.The address parameter is null.

ou-or- Le paramètre fileName a la valeur null.The fileName parameter is null.

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.The URI formed by combining BaseAddress and address is invalid.

- ou --or- Une erreur s'est produite lors du téléchargement de la ressource.An error occurred while downloading the resource.

Le fichier local spécifié par fileName est utilisé par un autre thread.The local file specified by fileName is in use by another thread.

Remarques

Cette méthode télécharge la ressource au niveau de l’URI spécifié par dans le paramètre address.This method downloads the resource at the URI specified by in the address parameter. Une fois le téléchargement terminé, le fichier téléchargé est nommé fileName sur l’ordinateur local.When the download completes successfully, the downloaded file is named fileName on the local computer. Le fichier est téléchargé de manière asynchrone à l’aide des ressources de thread allouées automatiquement à partir du pool de threads.The file is downloaded asynchronously using thread resources that are automatically allocated from the thread pool. Pour recevoir une notification lorsque le fichier est disponible, ajoutez un gestionnaire d’événements à l’événement DownloadFileCompleted.To receive notification when the file is available, add an event handler to the DownloadFileCompleted event.

Cette méthode ne bloque pas le thread appelant pendant le téléchargement de la ressource.This method does not block the calling thread while the resource is being downloaded. Pour bloquer en attendant que le téléchargement se termine, utilisez l’une des méthodes DownloadFile.To block while waiting for the download to complete, use one of the DownloadFile methods.

Vous pouvez utiliser la méthode CancelAsync pour annuler des opérations asynchrones qui n’ont pas été terminées.You can use the CancelAsync method to cancel asynchronous operations that have not completed.

Si la propriété BaseAddress n’est pas une chaîne vide ("") et que address ne spécifie pas d’URI absolu, address doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées.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. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.If the QueryString property is not an empty string, it is appended to address.

Cette méthode utilise la commande RETR pour télécharger une ressource FTP.This method uses the RETR command to download an FTP resource. Pour une ressource HTTP, la méthode d’extraction est utilisée.For an HTTP resource, the GET method is used.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application.This member outputs trace information when you enable network tracing in your application. Pour plus d’informations, consultez la page traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

Lorsque vous utilisez cette méthode dans une page ASP.NET, vous recevrez une erreur si le compte sous lequel la page s’exécute n’est pas autorisé à accéder au fichier local.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)

Télécharge, vers un fichier local, la ressource ayant l'URI spécifié.Downloads, to a local file, the resource with the specified URI. Cette méthode ne bloque pas le thread appelant.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)

Paramètres

address
Uri Uri Uri Uri

URI de la ressource à télécharger.The URI of the resource to download.

fileName
String String String String

Nom du fichier à placer sur l'ordinateur local.The name of the file to be placed on the local computer.

userToken
Object Object Object Object

Objet défini par l'utilisateur, passé à la fin de l'opération asynchrone à la méthode appelée.A user-defined object that is passed to the method invoked when the asynchronous operation completes.

Exceptions

Le paramètre address a la valeur null.The address parameter is null.

- ou --or- Le paramètre fileName a la valeur null.The fileName parameter is null.

L'URI formé en combinant la propriété BaseAddress et address n'est pas valide.The URI formed by combining BaseAddress and address is invalid.

- ou --or- Une erreur s'est produite lors du téléchargement de la ressource.An error occurred while downloading the resource.

Le fichier local spécifié par fileName est utilisé par un autre thread.The local file specified by fileName is in use by another thread.

Remarques

Cette méthode télécharge la ressource au niveau de l’URI spécifié par dans le paramètre address.This method downloads the resource at the URI specified by in the address parameter. Une fois le téléchargement terminé, le fichier téléchargé est nommé fileName sur l’ordinateur local.When the download completes successfully, the downloaded file is named fileName on the local computer. Le fichier est téléchargé de manière asynchrone à l’aide des ressources de thread allouées automatiquement à partir du pool de threads.The file is downloaded asynchronously using thread resources that are automatically allocated from the thread pool. Pour recevoir une notification lorsque le fichier est disponible, ajoutez un gestionnaire d’événements à l’événement DownloadFileCompleted.To receive notification when the file is available, add an event handler to the DownloadFileCompleted event.

Cette méthode ne bloque pas le thread appelant pendant le téléchargement de la ressource.This method does not block the calling thread while the resource is being downloaded. Pour bloquer en attendant que le téléchargement se termine, utilisez l’une des méthodes DownloadFile.To block while waiting for the download to complete, use one of the DownloadFile methods.

Vous pouvez utiliser la méthode CancelAsync pour annuler des opérations asynchrones qui n’ont pas été terminées.You can use the CancelAsync method to cancel asynchronous operations that have not completed.

Si la propriété BaseAddress n’est pas une chaîne vide ("") et que address ne spécifie pas d’URI absolu, address doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées.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. Si la propriété QueryString n’est pas une chaîne vide, elle est ajoutée à address.If the QueryString property is not an empty string, it is appended to address.

Cette méthode utilise la commande RETR pour télécharger une ressource FTP.This method uses the RETR command to download an FTP resource. Pour une ressource HTTP, la méthode d’extraction est utilisée.For an HTTP resource, the GET method is used.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application.This member outputs trace information when you enable network tracing in your application. Pour plus d’informations, consultez la page traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

Lorsque vous utilisez cette méthode dans une page ASP.NET, vous recevrez une erreur si le compte sous lequel la page s’exécute n’est pas autorisé à accéder au fichier local.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.

S’applique à