WebProxy Classe

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebProxy.dll

Source:

WebProxy.cs

Contient les paramètres du proxy HTTP pour la classe HttpClient.

public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable

public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

Public Class WebProxy
Implements ISerializable, IWebProxy

Héritage

Object

WebProxy

Implémente

IWebProxy ISerializable

Exemples

L’exemple de code suivant configure une HttpClient instance avec une WebProxy instance. L’instance HttpClient utilise le proxy pour se connecter à des ressources Internet externes. (Pour obtenir un exemple illustrant l’utilisation de la fonctionnalité WPAD, consultez la documentation de la IWebProxyScript classe.)

WebProxy^ proxyObject = gcnew WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClientHandler^ handler = gcnew HttpClientHandler();
handler->Proxy = proxyObject;
HttpClient^ client = gcnew HttpClient(handler);

WebProxy proxyObject = new WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Proxy = proxyObject
});

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)

' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Proxy = proxyObject
})

Remarques

La WebProxy classe contient les paramètres de proxy utilisés HttpClient par les instances pour déterminer si un proxy web est utilisé pour envoyer des demandes. Les paramètres de proxy web globaux peuvent être spécifiés dans les fichiers de configuration de l’ordinateur et de l’application, et les applications peuvent utiliser des instances de la classe pour personnaliser l’utilisation WebProxy du proxy Web. La WebProxy classe est l’implémentation de base de l’interface IWebProxy .

Pour obtenir des instances de la classe proxy Web, vous pouvez utiliser l’une des méthodes suivantes :

• Constructeur WebProxy.

• Méthode GetDefaultProxy

• Méthode Select

Ces méthodes fournissent chacune une WebProxy instance que vous pouvez personnaliser davantage ; la différence entre elles réside dans la façon dont l’instance est initialisée avant qu’elle ne soit retournée à votre application. Le WebProxy constructeur retourne une instance de la WebProxy classe avec la Address propriété définie sur null. Lorsqu’une requête utilise une WebProxy instance dans cet état, aucun proxy n’est utilisé pour envoyer la requête.

La GetDefaultProxy méthode retourne une instance de la WebProxy classe avec les Addresspropriétés , BypassProxyOnLocalet BypassList définies sur les valeurs utilisées par l’ordinateur local.

La Select méthode retourne une instance de la WebProxy classe avec ses propriétés définies en fonction d’une combinaison de paramètres Internet et de fichier de configuration.

La WebProxy classe prend en charge la détection et l’exécution automatiques de scripts de configuration de proxy. Cette fonctionnalité est également connue sous le nom de Découverte automatique de proxy Web (WPAD, Web Proxy Auto-Discovery). Lors de l’utilisation de la configuration automatique du proxy, un script de configuration, généralement nommé Wpad.dat, doit être localisé, téléchargé, compilé et exécuté. Si ces opérations réussissent, le script retourne les proxys qui peuvent être utilisés pour une demande.

Constructeurs

WebProxy()	Initialise une instance vide de la classe WebProxy.
WebProxy(SerializationInfo, StreamingContext)	Obsolète. Initialise une instance de la classe WebProxy avec du contenu précédemment sérialisé.
WebProxy(String)	Initialise une nouvelle instance de la classe WebProxy avec l'URI spécifié.
WebProxy(String, Boolean)	Initialise une nouvelle instance de la classe WebProxy avec l’URI et le paramètre d’exception spécifiés.
WebProxy(String, Boolean, String[])	Initialise une nouvelle instance de la classe WebProxy avec l’URI, le paramètre d’exception et la liste des URI à ignorer spécifiés.
WebProxy(String, Boolean, String[], ICredentials)	Initialise une nouvelle instance de la classe WebProxy avec l’URI, le paramètre d’exception, la liste des URI à ignorer et les informations d’identification spécifiés.
WebProxy(String, Int32)	Initialise une nouvelle instance de la classe WebProxy avec l’hôte et le numéro de port spécifiés.
WebProxy(Uri)	Initialise une nouvelle instance de la classe WebProxy issue de l'instance Uri spécifiée.
WebProxy(Uri, Boolean)	Initialise une nouvelle instance de la classe WebProxy avec l’instance de Uri et le paramètre d’exception.
WebProxy(Uri, Boolean, String[])	Initialise une nouvelle instance de la classe WebProxy avec l’instance de Uri, le paramètre d’exception et la liste des URI à ignorer spécifiés.
WebProxy(Uri, Boolean, String[], ICredentials)	Initialise une nouvelle instance de la classe WebProxy avec l’instance de Uri, le paramètre d’exception, la liste des URI à ignorer et les informations d’identification spécifiés.

Propriétés

Address	Obtient ou définit l’adresse du serveur proxy.
BypassArrayList	Obtient une liste d’adresses qui n’utilisent pas le serveur proxy.
BypassList	Obtient ou définit un tableau d’adresses qui n’utilisent pas le serveur proxy.
BypassProxyOnLocal	Obtient ou définit une valeur qui indique s'il convient d'ignorer le serveur proxy pour les adresses locales.
Credentials	Obtient ou définit les informations d’identification à envoyer au serveur proxy pour l’authentification.
UseDefaultCredentials	Obtient ou définit une valeur Boolean qui contrôle si les DefaultCredentials sont envoyés avec les demandes.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetDefaultProxy()	Obsolète. Lit les paramètres de proxy non dynamiques des options Internet.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetObjectData(SerializationInfo, StreamingContext)	Remplit SerializationInfo avec les données qui sont nécessaires pour sérialiser l'objet cible.
GetProxy(Uri)	Retourne l’URI proxy d’une demande.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsBypassed(Uri)	Indique si le serveur proxy doit être utilisé pour l’hôte spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Crée les données de sérialisation et le contexte qui sont utilisés par le système pour sérialiser un objet WebProxy.