WebClient.DownloadStringAsync, méthode (Uri, Object)

public void DownloadStringAsync (
	Uri address,
	Object userToken
)

public void DownloadStringAsync (
	Uri address, 
	Object userToken
)

public function DownloadStringAsync (
	address : Uri, 
	userToken : Object
)

Non applicable.

Paramètres

address

Uri contenant l'URI à télécharger.

userToken

Objet défini par l'utilisateur, passé à la fin de l'opération asynchrone à la méthode appelée.

Cette méthode récupère la ressource spécifiée à l'aide de la méthode GET. La ressource est téléchargée de manière asynchrone à l'aide de ressources de thread automatiquement allouées à partir du pool de threads.

Une fois la ressource téléchargée, cette méthode utilise le codage spécifié dans la propriété Encoding pour convertir la ressource en String. Cette méthode ne bloque pas le thread appelant pendant le téléchargement de la ressource. Pour télécharger une ressource et maintenir le blocage dans l'attente de la réponse du serveur, utilisez la méthode DownloadString. Une fois le téléchargement terminé, l'événement DownloadStringCompleted est déclenché. Votre application doit gérer cet événement pour recevoir une notification. La chaîne téléchargée est disponible dans la propriété Result.

Vous pouvez utiliser la méthode CancelAsync pour annuler des opérations asynchrones qui ne sont pas terminées.

Si la propriété BaseAddress n'est pas une chaîne vide ("") et que address ne contient pas un URI absolu, address doit être un URI relatif combiné avec BaseAddress pour former l'URI absolu des données demandées. Si la propriété QueryString n'est pas une chaîne vide, elle est ajoutée à address.

Cette méthode utilise la commande RETR pour télécharger une ressource FTP. Pour une ressource HTTP, la méthode GET est utilisée.

Remarque :
Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d'informations, consultez Traçage réseau.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework