Partager via


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

Configure le serveur proxy HTTP (Hypertext Transfer Protocol).

<configuration><system.net><defaultProxy>

Note

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

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.

Attributes

Élément 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 de cet hôte sont utilisées pour accéder au proxy web. La valeur par défaut est False.

Éléments enfants

Élément Description
bypasslist Fournit un ensemble d’expressions régulières qui décrivent les adresses qui n’utilisent pas le proxy.
module Ajoute un nouveau module proxy à l’application.
procuration Définit un serveur proxy.

Éléments parents

Élément 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 si l’élément de module spécifie un type non public, le type n’est pas dérivé de la IWebProxy classe, une exception du constructeur sans paramètre de cet objet s’est produite ou une exception s’est produite lors de la récupération du proxy par défaut spécifié par le système. La InnerException propriété sur l’exception doit avoir plus d’informations sur la cause racine de l’erreur.

Fichiers de configuration

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

Example

L’exemple suivant utilise les valeurs par défaut du proxy 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