BasicHttpBinding.BypassProxyOnLocal Propriété

Définition

Espace de noms:

System.ServiceModel

Assembly:

System.ServiceModel.dll

Obtient ou définit une valeur qui indique s'il convient d'ignorer le serveur proxy pour les adresses locales.

public:
 property bool BypassProxyOnLocal { bool get(); void set(bool value); };

public bool BypassProxyOnLocal { get; set; }

member this.BypassProxyOnLocal : bool with get, set

Public Property BypassProxyOnLocal As Boolean

Valeur de propriété

Boolean

true pour ignorer le serveur proxy pour les adresses locales ; sinon, false. La valeur par défaut est false.

Exemples

L'exemple suivant définit cette propriété de manière à ce que le proxy soit contourné pour les ressources locales.

BasicHttpBinding binding = new BasicHttpBinding();
binding.BypassProxyOnLocal = true;

La valeur de cette propriété peut également être définie dans le fichier de configuration.

<configuration>
  <system.serviceModel>

    <bindings>
      <basicHttpBinding>
        <binding name="Binding1" 
                 bypassProxyOnLocal="true">
          <security mode="None" />
        </binding>
      </basicHttpBinding>
    </bindings>
  </system.serviceModel>

</configuration>

Remarques

Une ressource Internet est locale si elle dispose d'une adresse locale. Une adresse locale est une adresse qui se trouve sur le même ordinateur, le réseau local ou l’intranet et est identifiée, syntaxiquement, par l’absence d’un point (.) comme dans les URI http://webserver/ et http://localhost/.

La définition de la propriété BypassProxyOnLocal détermine si les points de terminaison configurés avec le BasicHttpBinding utilisent le serveur proxy lors de l’accès aux ressources locales.

Si BypassProxyOnLocal a la valeur true, les demandes adressées aux ressources Internet locales n’utilisent pas le serveur proxy. Utilisez le nom d'hôte (plutôt que localhost) si vous voulez que les clients traversent un proxy lorsqu'ils s'adressent à des services sur le même ordinateur lorsque que cette propriété a la valeur true.

Lorsque BypassProxyOnLocal a la valeur false, toutes les requêtes Internet adressées aux URI non localhost sont effectuées via le serveur proxy. Les demandes adressées aux URI avec localhost n’utilisent pas le serveur proxy, quel que soit le paramètre BypassProxyOnLocal.