HttpClient.DefaultProxy Propriété

Définition

Espace de noms:

System.Net.Http

Assembly:

System.Net.Http.dll

Source:

HttpClient.cs

Obtient ou définit le proxy HTTP global.

public:
 static property System::Net::IWebProxy ^ DefaultProxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };

public static System.Net.IWebProxy DefaultProxy { get; set; }

static member DefaultProxy : System.Net.IWebProxy with get, set

Public Shared Property DefaultProxy As IWebProxy

Valeur de propriété

IWebProxy

Proxy utilisé par chaque requête HTTP.

Exceptions

ArgumentNullException

La valeur passée ne peut pas être null.

Remarques

Cette propriété statique détermine le proxy par défaut que toutes les HttpClient instances utilisent si aucun proxy n’est défini explicitement dans le HttpMessageHandler passé via son constructeur.

L’instance par défaut retournée par cette propriété s’initialise selon un ensemble différent de règles en fonction de votre plateforme :

• Pour Windows : lit la configuration du proxy à partir de variables d’environnement ou, si celles-ci ne sont pas définies, à partir des paramètres de proxy de l’utilisateur.

• Pour macOS : lit la configuration du proxy à partir de variables d’environnement ou, si celles-ci ne sont pas définies, à partir des paramètres de proxy du système.

• Pour Linux : lit la configuration du proxy à partir de variables d’environnement ou, si celles-ci ne sont pas définies, cette propriété initialise une instance non configurée qui contourne toutes les adresses.

Les variables d’environnement utilisées pour l’initialisation de DefaultProxy sur les plateformes Windows et Unix sont les suivantes :

• HTTP_PROXY : serveur proxy utilisé sur les demandes HTTP.
• HTTPS_PROXY : serveur proxy utilisé sur les demandes HTTPS.
• ALL_PROXY : serveur proxy utilisé sur les requêtes HTTP et/ou HTTPS au cas où HTTP_PROXY et/ou HTTPS_PROXY ne sont pas définis.
• NO_PROXY : liste de noms d’hôte séparés par des virgules à exclure comme proxy. Les astérisques ne sont pas pris en charge pour les caractères génériques ; utilisez un point de début au cas où vous souhaitez faire correspondre un sous-domaine. Exemples : NO_PROXY=.example.com (avec point de début) correspond à www.example.com, mais ne correspond pas àexample.com. NO_PROXY=example.com (sans point de début) ne correspond pas à www.example.com. Ce comportement peut être revisité à l’avenir pour mieux correspondre à d’autres écosystèmes.

Sur les systèmes où les variables d’environnement sont sensibles à la casse, les noms des variables peuvent être tout en minuscules ou tout en minuscules. Les noms en minuscules sont vérifiés en premier.

Le serveur proxy peut être un nom d’hôte ou une adresse IP, éventuellement suivi d’un signe deux-points et d’un numéro de port, ou il peut s’agir d’une URL http, avec éventuellement un nom d’utilisateur et un mot de passe pour l’authentification proxy. L’URL doit commencer par http, et non pas https, et ne peut pas inclure de texte après le nom d’hôte, l’adresse IP ou le port.