WebClient.DownloadStringAsync WebClient.DownloadStringAsync WebClient.DownloadStringAsync WebClient.DownloadStringAsync Method

Définition

Télécharge la ressource spécifiée en tant que String ou Uri.Downloads the resource specified as a String or a Uri. Ces méthodes ne bloquent pas le thread appelant.These methods do not block the calling thread.

Surcharges

DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri)

Télécharge la ressource spécifiée en tant que Uri.Downloads the resource specified as a Uri. Cette méthode ne bloque pas le thread appelant.This method does not block the calling thread.

DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object)

Télécharge la chaîne spécifiée vers la ressource spécifiée.Downloads the specified string to the specified resource. Cette méthode ne bloque pas le thread appelant.This method does not block the calling thread.

DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri) DownloadStringAsync(Uri)

Télécharge la ressource spécifiée en tant que Uri.Downloads the resource specified as a Uri. Cette méthode ne bloque pas le thread appelant.This method does not block the calling thread.

public:
 void DownloadStringAsync(Uri ^ address);
public void DownloadStringAsync (Uri address);
member this.DownloadStringAsync : Uri -> unit
Public Sub DownloadStringAsync (address As Uri)

Paramètres

address
Uri Uri Uri Uri

Uri contenant l'URI à télécharger.A Uri containing the URI to download.

Exceptions

Le paramètre address a la valeur null.The address 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.

Remarques

La ressource est téléchargée de manière asynchrone à l’aide des ressources de thread allouées automatiquement à partir du pool de threads.The resource is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

Après avoir téléchargé la ressource, cette méthode utilise l’encodage spécifié Encoding dans la propriété pour convertir la ressource Stringen.After downloading the resource, this method uses the encoding specified in the Encoding property to convert the resource to a String. Cette méthode ne bloque pas le thread appelant lors du téléchargement de la ressource.This method does not block the calling thread while downloading the resource. Pour télécharger une ressource et bloquer en attendant la réponse du serveur, utilisez la DownloadString méthode.To download a resource and block while waiting for the server's response, use the DownloadString method. Une fois le téléchargement terminé, l' DownloadStringCompleted événement est déclenché.When the download completes, the DownloadStringCompleted event is raised. Votre application doit gérer cet événement pour recevoir une notification.Your application must handle this event to receive notification. La chaîne téléchargée est disponible dans Result la propriété.The downloaded string is available in the Result property.

Vous pouvez utiliser la CancelAsync méthode 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 BaseAddress propriété n’est pas une chaîne vide ("") address et ne contient pas d’URI absolu address , doit être un URI relatif qui est combiné BaseAddress avec pour former l’URI absolu des données demandées.If the BaseAddress property is not an empty string ("") and address does not contain 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 QueryString propriété 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.

DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object) DownloadStringAsync(Uri, Object)

Télécharge la chaîne spécifiée vers la ressource spécifiée.Downloads the specified string to the specified resource. Cette méthode ne bloque pas le thread appelant.This method does not block the calling thread.

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

Paramètres

address
Uri Uri Uri Uri

Uri contenant l'URI à télécharger.A Uri containing the URI to download.

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.

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.

Remarques

La ressource est téléchargée de manière asynchrone à l’aide des ressources de thread allouées automatiquement à partir du pool de threads.The resource is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

Après avoir téléchargé la ressource, cette méthode utilise l’encodage spécifié Encoding dans la propriété pour convertir la ressource Stringen.After downloading the resource, this method uses the encoding specified in the Encoding property to convert the resource to a String. Cette méthode ne bloque pas le thread appelant lors du téléchargement de la ressource.This method does not block the calling thread while downloading the resource. Pour télécharger une ressource et bloquer en attendant la réponse du serveur, utilisez la DownloadString méthode.To download a resource and block while waiting for the server's response, use the DownloadString method. Une fois le téléchargement terminé, l' DownloadStringCompleted événement est déclenché.When the download completes, the DownloadStringCompleted event is raised. Votre application doit gérer cet événement pour recevoir une notification.Your application must handle this event to receive notification. La chaîne téléchargée est disponible dans Result la propriété.The downloaded string is available in the Result property.

Vous pouvez utiliser la CancelAsync méthode 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 BaseAddress propriété n’est pas une chaîne vide ("") address et ne contient pas d’URI absolu address , doit être un URI relatif qui est combiné BaseAddress avec pour former l’URI absolu des données demandées.If the BaseAddress property is not an empty string ("") and address does not contain 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 QueryString propriété 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.

S’applique à