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

Article
08/17/2023

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>

Partage via