Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

WebClient, classe

.NET Framework 4

Autres versions

Fournit des méthodes communes pour l'envoi de données à une ressource identifiée par un URI ou pour la réception de données en provenance de cette ressource.

Hiérarchie d'héritage

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Net.WebClient

Espace de noms : System.Net
Assembly : System (dans System.dll)

Syntaxe

C++

Copier

[ComVisibleAttribute(true)]
public class WebClient : Component

Le type WebClient expose les membres suivants.

Constructeurs

	Nom	Description
	WebClient	Initialise une nouvelle instance de la classe WebClient.

Début

Propriétés

	Nom	Description
	BaseAddress	Obtient ou définit l'URI de base pour les requêtes effectuées par WebClient.
	CachePolicy	Obtient ou définit la stratégie de cache de l'application pour les ressources obtenues par cette instance WebClient à l'aide d'objets WebRequest.
	CanRaiseEvents	Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component.)
	Container	Obtient le IContainer qui contient Component. (Hérité de Component.)
	Credentials	Obtient ou définit les informations d'identification réseau envoyées à l'hôte et utilisées pour authentifier la demande.
	DesignMode	Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component.)
	Encoding	Obtient et définit le Encoding utilisé pour transférer et télécharger des chaînes.
	Events	Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component.)
	Headers	Obtient ou définit une collection de paires nom/valeur d'en-tête associées à la demande.
	IsBusy	Détermine si une demande Web est en cours.
	Proxy	Obtient ou définit le proxy utilisé par cet objet WebClient.
	QueryString	Obtient ou définit une collection de paires nom/valeur de requête associées à la demande.
	ResponseHeaders	Obtient une collection de paires nom/valeur d'en-tête associées à la réponse.
	Site	Obtient ou définit le ISite de Component. (Hérité de Component.)
	UseDefaultCredentials	Obtient ou définit une valeur Boolean qui contrôle si les DefaultCredentials sont envoyés avec les demandes.

Début

Méthodes

	Nom	Description
	CancelAsync	Annule une opération asynchrone en attente.
	CreateObjRef	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject.)
	Dispose()	Libère toutes les ressources utilisées par Component. (Hérité de Component.)
	Dispose(Boolean)	Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées. (Hérité de Component.)
	DownloadData(String)	Télécharge la ressource avec l'URI spécifié en tant que tableau de Byte.
	DownloadData(Uri)	Télécharge la ressource avec l'URI spécifié en tant que tableau de Byte.
	DownloadDataAsync(Uri)	Télécharge la ressource spécifiée en tant que tableau de Byte. Cette méthode ne bloque pas le thread appelant.
	DownloadDataAsync(Uri, Object)	Télécharge la ressource spécifiée en tant que tableau de Byte. Cette méthode ne bloque pas le thread appelant.
	DownloadFile(String, String)	Télécharge vers un fichier local la ressource ayant l'URI spécifié.
	DownloadFile(Uri, String)	Télécharge vers un fichier local la ressource ayant l'URI spécifié.
	DownloadFileAsync(Uri, String)	Télécharge, vers un fichier local, la ressource ayant l'URI spécifié. Cette méthode ne bloque pas le thread appelant.
	DownloadFileAsync(Uri, String, Object)	Télécharge, vers un fichier local, la ressource ayant l'URI spécifié. Cette méthode ne bloque pas le thread appelant.
	DownloadString(String)	Télécharge la ressource demandée en tant que String. La ressource à télécharger est spécifiée comme String contenant l'URI.
	DownloadString(Uri)	Télécharge la ressource demandée en tant que String. La ressource à télécharge est spécifiée comme Uri.
	DownloadStringAsync(Uri)	Télécharge la ressource spécifiée en tant que Uri. Cette méthode ne bloque pas le thread appelant.
	DownloadStringAsync(Uri, Object)	Télécharge la chaîne spécifiée vers la ressource spécifiée. Cette méthode ne bloque pas le thread appelant.
	Equals(Object)	Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
	Finalize	Libère les ressources non managées et exécute d'autres opérations de nettoyage avant la récupération de Component par le garbage collection. (Hérité de Component.)
	GetHashCode	Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
	GetLifetimeService	Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject.)
	GetService	Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component.)
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	GetWebRequest	Retourne un objet WebRequest pour la ressource spécifiée.
	GetWebResponse(WebRequest)	Retourne WebResponse pour le WebRequest spécifié.
	GetWebResponse(WebRequest, IAsyncResult)	Retourne WebResponse pour le WebRequest spécifié à l'aide du IAsyncResult spécifié.
	InitializeLifetimeService	Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject.)
	MemberwiseClone()	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject.)
	OnDownloadDataCompleted	Déclenche l'événement DownloadDataCompleted.
	OnDownloadFileCompleted	Déclenche l'événement DownloadFileCompleted.
	OnDownloadProgressChanged	Déclenche l'événement DownloadProgressChanged.
	OnDownloadStringCompleted	Déclenche l'événement DownloadStringCompleted.
	OnOpenReadCompleted	Déclenche l'événement OpenReadCompleted.
	OnOpenWriteCompleted	Déclenche l'événement OpenWriteCompleted.
	OnUploadDataCompleted	Déclenche l'événement UploadDataCompleted.
	OnUploadFileCompleted	Déclenche l'événement UploadFileCompleted.
	OnUploadProgressChanged	Déclenche l'événement UploadProgressChanged.
	OnUploadStringCompleted	Déclenche l'événement UploadStringCompleted.
	OnUploadValuesCompleted	Déclenche l'événement UploadValuesCompleted.
	OpenRead(String)	Ouvre un flux accessible en lecture pour les données téléchargées à partir d'une ressource ayant l'URI spécifié en tant que String.
	OpenRead(Uri)	Ouvre un flux accessible en lecture pour les données téléchargées à partir d'une ressource ayant l'URI spécifié en tant que Uri.
	OpenReadAsync(Uri)	Ouvre un flux accessible en lecture et contenant la ressource spécifiée. Cette méthode ne bloque pas le thread appelant.
	OpenReadAsync(Uri, Object)	Ouvre un flux accessible en lecture et contenant la ressource spécifiée. Cette méthode ne bloque pas le thread appelant.
	OpenWrite(String)	Ouvre un flux pour l'écriture de données sur la ressource spécifiée.
	OpenWrite(Uri)	Ouvre un flux pour l'écriture de données sur la ressource spécifiée.
	OpenWrite(String, String)	Ouvre un flux pour écrire des données dans la ressource spécifiée, à l'aide de la méthode spécifiée.
	OpenWrite(Uri, String)	Ouvre un flux pour écrire des données dans la ressource spécifiée en utilisant la méthode spécifiée.
	OpenWriteAsync(Uri)	Ouvre un flux pour l'écriture de données sur la ressource spécifiée. Cette méthode ne bloque pas le thread appelant.
	OpenWriteAsync(Uri, String)	Ouvre un flux pour l'écriture de données sur la ressource spécifiée. Cette méthode ne bloque pas le thread appelant.
	OpenWriteAsync(Uri, String, Object)	Ouvre un flux pour écrire des données dans la ressource spécifiée, à l'aide de la méthode spécifiée. Cette méthode ne bloque pas le thread appelant.
	ToString	Retourne String contenant le nom du Component, s'il existe. Cette méthode ne doit pas être substituée. (Hérité de Component.)
	UploadData(String, Byte[])	Transmet une mémoire tampon de données à une ressource identifiée par un URI.
	UploadData(Uri, Byte[])	Transmet une mémoire tampon de données à une ressource identifiée par un URI.
	UploadData(String, String, Byte[])	Transfère un tampon de données vers la ressource spécifiée, à l'aide de la méthode spécifiée.
	UploadData(Uri, String, Byte[])	Transfère un tampon de données vers la ressource spécifiée, à l'aide de la méthode spécifiée.
	UploadDataAsync(Uri, Byte[])	Transfère un tampon de données à une ressource identifiée par un URI, à l'aide de la méthode POST. Cette méthode ne bloque pas le thread appelant.
	UploadDataAsync(Uri, String, Byte[])	Transfère un tampon de données à une ressource identifiée par un URI, à l'aide de la méthode spécifiée. Cette méthode ne bloque pas le thread appelant.
	UploadDataAsync(Uri, String, Byte[], Object)	Transfère un tampon de données à une ressource identifiée par un URI, à l'aide de la méthode et du jeton d'identification spécifiés.
	UploadFile(String, String)	Transfère le fichier local spécifié à une ressource ayant l'URI spécifié.
	UploadFile(Uri, String)	Transfère le fichier local spécifié à une ressource ayant l'URI spécifié.
	UploadFile(String, String, String)	Transfère le fichier local spécifié vers la ressource spécifiée en utilisant la méthode spécifiée.
	UploadFile(Uri, String, String)	Transfère le fichier local spécifié vers la ressource spécifiée en utilisant la méthode spécifiée.
	UploadFileAsync(Uri, String)	Transfère le fichier local spécifié vers la ressource spécifiée en utilisant la méthode POST. Cette méthode ne bloque pas le thread appelant.
	UploadFileAsync(Uri, String, String)	Transfère le fichier local spécifié vers la ressource spécifiée en utilisant la méthode POST. Cette méthode ne bloque pas le thread appelant.
	UploadFileAsync(Uri, String, String, Object)	Transfère le fichier local spécifié vers la ressource spécifiée en utilisant la méthode POST. Cette méthode ne bloque pas le thread appelant.
	UploadString(String, String)	Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant la méthode POST.
	UploadString(Uri, String)	Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant la méthode POST.
	UploadString(String, String, String)	Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant la méthode indiquée.
	UploadString(Uri, String, String)	Transfère la chaîne spécifiée vers la ressource spécifiée en utilisant la méthode indiquée.
	UploadStringAsync(Uri, String)	Transfère la chaîne spécifiée vers la ressource spécifiée. Cette méthode ne bloque pas le thread appelant.
	UploadStringAsync(Uri, String, String)	Transfère la chaîne spécifiée vers la ressource spécifiée. Cette méthode ne bloque pas le thread appelant.
	UploadStringAsync(Uri, String, String, Object)	Transfère la chaîne spécifiée vers la ressource spécifiée. Cette méthode ne bloque pas le thread appelant.
	UploadValues(String, NameValueCollection)	Transfère la collection nom/valeur spécifiée à la ressource identifiée par l'URI spécifié.
	UploadValues(Uri, NameValueCollection)	Transfère la collection nom/valeur spécifiée à la ressource identifiée par l'URI spécifié.
	UploadValues(String, String, NameValueCollection)	Transfère la collection nom/valeur spécifiée à la ressource identifiée par l'URI spécifié, à l'aide de la méthode spécifiée.
	UploadValues(Uri, String, NameValueCollection)	Transfère la collection nom/valeur spécifiée à la ressource identifiée par l'URI spécifié, à l'aide de la méthode spécifiée.
	UploadValuesAsync(Uri, NameValueCollection)	Transfère les données de la collection nom/valeur spécifiée à la ressource identifiée par l'URI spécifié. Cette méthode ne bloque pas le thread appelant.
	UploadValuesAsync(Uri, String, NameValueCollection)	Transfère les données de la collection nom/valeur spécifiée à la ressource identifiée par l'URI spécifié, à l'aide de la méthode spécifiée. Cette méthode ne bloque pas le thread appelant.
	UploadValuesAsync(Uri, String, NameValueCollection, Object)	Transfère les données de la collection nom/valeur spécifiée à la ressource identifiée par l'URI spécifié, à l'aide de la méthode spécifiée. Cette méthode ne bloque pas le thread appelant et permet à l'appelant de passer un objet à la méthode qui est appelée lorsque l'opération se termine.

Début

Événements

	Nom	Description
	Disposed	Se produit lorsque le composant est supprimé par un appel à la méthode Dispose. (Hérité de Component.)
	DownloadDataCompleted	Se produit lors d'une opération asynchrone de téléchargement de données.
	DownloadFileCompleted	Se produit lors d'une opération asynchrone de téléchargement de fichiers.
	DownloadProgressChanged	Se produit lorsqu'une opération de téléchargement asynchrone transfère avec succès une partie ou l'ensemble des données.
	DownloadStringCompleted	Se produit lors d'une opération asynchrone de téléchargement de ressources.
	OpenReadCompleted	Se produit lors d'une opération asynchrone d'ouverture d'un flux contenant une ressource.
	OpenWriteCompleted	Se produit lors d'une opération asynchrone d'ouverture d'un flux pour écrire des données dans une ressource.
	UploadDataCompleted	Se produit lors d'une opération asynchrone de transfert de données.
	UploadFileCompleted	Se produit lors d'une opération asynchrone de transfert de fichiers.
	UploadProgressChanged	Se produit lorsqu'une opération de transfert asynchrone transmet avec succès une partie ou l'ensemble des données.
	UploadStringCompleted	Se produit lors d'une opération asynchrone de transfert de chaînes.
	UploadValuesCompleted	Se produit lors d'un transfert asynchrone d'une collection nom/valeur.

Début

Notes

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 WebClient peuvent accéder aux données avec tout descendant WebRequest enregistré 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
OpenWrite	Récupère Stream utilisé pour envoyer des données à la ressource.
OpenWriteAsync	Récupère Stream utilisé pour envoyer des données à la ressource, sans bloquer le thread appelant.
UploadData	Envoie un tableau d'octets à la ressource et retourne un tableau de Byte contenant une réponse.
UploadDataAsync	Envoie un tableau de Byte à la ressource, sans bloquer le thread appelant.
UploadFile	Envoie un fichier local à la ressource et retourne un tableau de Byte contenant une réponse.
UploadFileAsync	Envoie un fichier local à la ressource, sans bloquer le thread appelant.
UploadValues	Envoie un NameValueCollection à la ressource et retourne un tableau de Byte contenant une réponse.
UploadValuesAsync	Envoie un NameValueCollection à la ressource et retourne un tableau de Byte contenant une réponse, sans bloquer le thread appelant.
UploadString	Envoie String à la ressource, sans bloquer le thread appelant.
UploadStringAsync	Envoie String à la ressource, sans bloquer le thread appelant.

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

Méthode	Description
OpenRead	Retourne les données d'une ressource sous la forme d'un Stream.
OpenReadAsync	Retourne les données d'une ressource, sans bloquer le thread appelant.
DownloadData	Télécharge des données en provenance d'une ressource et retourne un tableau de Byte.
DownloadDataAsync	Télécharge des données en provenance d'une ressource et retourne un tableau de Byte, sans bloquer le thread appelant.
DownloadFile	Télécharge dans un fichier local des données en provenance d'une ressource.
DownloadFileAsync	Télécharge dans un fichier local des données en provenance d'une ressource, sans bloquer le thread appelant.
DownloadString	Télécharge String en provenance d'une ressource et retourne String.
DownloadStringAsync	Télécharge String en provenance d'une ressource, sans bloquer le thread appelant.

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.

Exemples

L'exemple de code suivant prend l'URI d'une ressource, le récupère, puis affiche la réponse.

C++

Copier


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 ();
    }
}

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Pris en charge dans :

Sécurité .NET Framework

WebPermission
pour accéder à l'URI demandé ou à tout URI vers lequel la demande est redirigée. Énumération associée : Connect.

Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

System.Net, espace de noms

WebRequest

WebResponse

HttpWebRequest

HttpWebResponse

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Contenu de la communauté Ajouter

FAQ