WebClient, classe

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.

Le tableau suivant décrit les méthodes WebClient pour le téléchargement de données d'une ressource.

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.

.NET Framework