Partager via

<proxy> Élément (Paramètres réseau)

Définit un serveur proxy.

<Configuration>
   <system.net>
     <defaultProxy>
       <procuration>

Syntaxe

<proxy
  autoDetect="True|False|Unspecified"
  bypassonlocal="True|False|Unspecified"
  proxyaddress="uriString"
  scriptLocation="uriString"
  usesystemdefault="True|False|Unspecified"
/>

Attributs et éléments

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

Attributes

Attribut Description
autoDetect Spécifie si le proxy est détecté automatiquement. La valeur par défaut est Unspecified.
bypassonlocal Spécifie si le proxy est contourné pour les ressources locales. Les ressources locales incluent le serveur local (http://localhost, http://loopbackou http://127.0.0.1) et un URI sans point (http://webserver). La valeur par défaut est Unspecified.
proxyaddress Spécifie l’URI du proxy à utiliser.
scriptLocation Spécifie l’emplacement du script de configuration. N’utilisez pas l’attribut bypassonlocal avec cet attribut.
usesystemdefault Spécifie s’il faut utiliser les paramètres de proxy système. Si la valeur est définie True, les attributs suivants remplacent les paramètres de proxy système. La valeur par défaut est Unspecified.

Éléments enfants

Aucun.

Éléments parents

Élément Description
defaultProxy Configure le serveur proxy HTTP (Hypertext Transfer Protocol).

Valeur de texte

Remarques

L’élément proxy définit un serveur proxy pour une application. Si cet élément est manquant dans le fichier de configuration, .NET Framework utilise les paramètres du proxy système.

La valeur de l’attribut proxyaddress doit être un URI (Uniform Resource Indicator) bien formé.

L’attribut scriptLocation fait référence à la détection automatique des scripts de configuration de proxy. La WebProxy classe tente de localiser un script de configuration (généralement nommé Wpad.dat) lorsque l’option Utiliser le script de configuration automatique est sélectionnée pour la connexion dans les propriétés Internet. Si bypassonlocal elle est définie sur une valeur, scriptLocation elle est ignorée.

Une exception est levée si l’attribut proxyaddress spécifie un proxy par défaut non valide. 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.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy
        usesystemdefault="True"
        proxyaddress="http://192.168.1.10:3128"
        bypassonlocal="True"
      />
    </defaultProxy>
  </system.net>
</configuration>

Voir aussi

  • Last updated on