WebClient, classe
Assembly : System (dans system.dll)
La classe WebClient fournit des méthodes communes pour l'envoi de données à n'importe quelle ressource locale, intranet ou Internet identifiée par un URI ou pour la réception de données à partir de cette ressource.
La classe WebClient utilise la classe WebRequest pour fournir l'accès aux ressources. Les instances de WebClient peuvent accéder aux données avec tous les descendants de WebRequest inscrits avec la méthode WebRequest.RegisterPrefix.
 Remarque |
|---|
| Par défaut, le .NET Framework prend en charge les URI qui commencent par les identificateurs de modèle http:, https:, ftp: et file:. |
Le tableau suivant décrit les méthodes WebClient pour le transfert de données à une ressource.
| Méthode | Description |
|---|---|
| Récupère Stream utilisé pour envoyer des données à la ressource. | |
| Récupère Stream utilisé pour envoyer des données à la ressource, sans bloquer le thread d'appel. | |
| Envoie un tableau d'octets à la ressource et retourne un tableau de Byte contenant une réponse. | |
| Envoie un tableau de Byte à la ressource, sans bloquer le thread d'appel. | |
| Envoie un fichier local à la ressource et retourne un tableau de Byte contenant une réponse. | |
| Envoie un fichier local à la ressource, sans bloquer le thread d'appel. | |
| Envoie un NameValueCollection à la ressource et retourne un tableau de Byte contenant une réponse. | |
| Envoie un NameValueCollection à la ressource et retourne un tableau de Byte contenant une réponse, sans bloquer le thread d'appel. | |
| Envoie String à la ressource, sans bloquer le thread d'appel. | |
| Envoie String à la ressource, sans bloquer le thread d'appel. |
Le tableau suivant décrit les méthodes WebClient pour le téléchargement de données d'une ressource.
| Méthode | Description |
|---|---|
| Retourne les données d'une ressource sous la forme d'un Stream. | |
| Retourne les données d'une ressource, sans bloquer le thread d'appel. | |
| Télécharge des données en provenance d'une ressource et retourne un tableau de Byte. | |
| Télécharge des données en provenance d'une ressource et retourne un tableau de Byte, sans bloquer le thread d'appel. | |
| Télécharge dans un fichier local des données en provenance d'une ressource. | |
| Télécharge dans un fichier local des données en provenance d'une ressource, sans bloquer le thread d'appel. | |
| Télécharge String en provenance d'une ressource et retourne String. | |
| Télécharge String en provenance d'une ressource, sans bloquer le thread d'appel. |
Vous pouvez utiliser la méthode CancelAsync pour annuler des opérations asynchrones qui ne sont pas terminées.
Par défaut, une instance de WebClient n'envoie pas les en-têtes HTTP facultatifs. Si votre demande requiert un en-tête facultatif, vous devez ajouter ce dernier à la collection Headers. Par exemple, pour conserver les requêtes dans une réponse, vous devez ajouter un en-tête d'agent utilisateur. Les serveurs peuvent également retourner 500 (erreur de serveur interne) en cas d'absence de l'en-tête d'agent utilisateur (user agent).
AllowAutoRedirect a la valeur true dans les instances de WebClient.
Remarques à l'attention des héritiers Les classes dérivées doivent appeler l'implémentation de la classe de base de WebClient pour garantir que la classe dérivée fonctionne comme prévu.L'exemple de code suivant prend l'URI d'une ressource, le récupère, puis affiche la réponse.
using System; using System.Net; using System.IO; public class Test { public static void Main (string[] args) { if (args == null || args.Length == 0) { throw new ApplicationException ("Specify the URI of the resource to retrieve."); } WebClient client = new WebClient (); // Add a user agent header in case the // requested URI contains a query. client.Headers.Add ("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.2; .NET CLR 1.0.3705;)"); Stream data = client.OpenRead (args[0]); StreamReader reader = new StreamReader (data); string s = reader.ReadToEnd (); Console.WriteLine (s); data.Close (); reader.Close (); } }
- WebPermission pour accéder à l'URI demandé ou à tout URI vers lequel la demande est redirigée. Énumération associée : Connect.
Windows 98, Windows 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
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Si vous souhaitez y participer,
