Élément <defaultProxy> (paramètres réseau)

  • Article

Configure le serveur proxy HTTP (Hypertext Transfer Protocol).

<configuration><system.net><defaultProxy>

Remarque

Si vous migrez vers .NET 6+, configurez le serveur proxy à l’aide de la propriété HttpClient.DefaultProxy.

Syntaxe

<defaultProxy
  enabled="True|False"
  useDefaultCredentials="True|False">
    <bypasslist>...</bypasslist>
    <proxy>...</proxy>
    <module>...</module>
</defaultProxy>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Element Description
enabled Spécifie si un proxy web est utilisé. La valeur par défaut est True.
useDefaultCredentials Spécifie si les informations d'identification par défaut associées à cet hôte sont utilisées pour accéder au proxy web. La valeur par défaut est False.

Éléments enfants

Element Description
bypasslist Fournit un ensemble d'expressions régulières décrivant les adresses qui n'utilisent pas le proxy.
module Ajoute un nouveau module proxy à l'application.
proxy Définit un serveur proxy.

Éléments parents

Element Description
system.net Contient des paramètres qui spécifient comment .NET Framework se connecte au réseau.

Remarques

Si l’élément defaultProxy est vide, les paramètres du proxy système sont utilisés.

Une exception est levée dans les cas suivants : l’élément module spécifie un type non public, le type ne dérive pas de la classe IWebProxy, une exception provenant du constructeur sans paramètre de cet objet s’est produite, ou une exception s’est produite au moment de la récupération du proxy par défaut spécifié par le système. La propriété InnerException de l'exception fournit normalement plus d'informations sur la cause première de l'erreur.

Les fichiers de configuration

Cet élément peut être défini dans le fichier de configuration de l'application ou dans le fichier de configuration de l'ordinateur (Machine.config).

Exemple

L’exemple de code suivant utilise les valeurs par défaut du proxy du système, spécifie l’adresse du proxy, et contourne le proxy pour l’accès local et contoso.com.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy
        usesystemdefault="True"
        proxyaddress="http://192.168.1.10:3128"
        bypassonlocal="True"
      />
      <bypasslist>
        <add address="[a-z]+\.contoso\.com$" />
      </bypasslist>
    </defaultProxy>
  </system.net>
</configuration>

Voir aussi