WebProxy.IsBypassed(Uri) Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebProxy.dll

Source:

WebProxy.cs

Indique si le serveur proxy doit être utilisé pour l’hôte spécifié.

public:
 virtual bool IsBypassed(Uri ^ host);

public bool IsBypassed (Uri host);

abstract member IsBypassed : Uri -> bool
override this.IsBypassed : Uri -> bool

Public Function IsBypassed (host As Uri) As Boolean

Paramètres

host

Uri

Instance de Uri de l’hôte dont l’utilisation du proxy doit être vérifiée.

Retours

Boolean

true si le serveur proxy ne doit pas être utilisé pour host ; sinon false.

Implémente

IsBypassed(Uri)

Exceptions

ArgumentNullException

Le paramètre host a la valeur null.

Exemples

L’exemple de code suivant crée un WebProxy objet et appelle cette méthode pour vérifier si la liste de contournement est correctement définie.

WebProxy^ CreateProxyAndCheckBypass( bool bypassLocal )
{
   // Do not use the proxy server for Contoso.com URIs.
   array<String^>^ bypassList = {";*.Contoso.com"};
   WebProxy^ proxy = gcnew WebProxy( "http://contoso",
      bypassLocal,
      bypassList );
   
   // Test the bypass list.
   if (  !proxy->IsBypassed( gcnew Uri( "http://www.Contoso.com" ) ) )
   {
      Console::WriteLine( "Bypass not working!" );
      return nullptr;
   }
   else
   {
      Console::WriteLine( "Bypass is working." );
      return proxy;
   }
}

public static WebProxy CreateProxyAndCheckBypass(bool bypassLocal)
{
    // Do not use the proxy server for Contoso.com URIs.
    string[] bypassList = new string[]{";*.Contoso.com"};
    WebProxy proxy =  new WebProxy("http://contoso",
        bypassLocal,
        bypassList);

    // Test the bypass list.
    if (!proxy.IsBypassed(new Uri("http://www.Contoso.com")))
    {
        Console.WriteLine("Bypass not working!");
        return null;
    }
    else
    {
        Console.WriteLine("Bypass is working.");
        return proxy;
    }
}

Remarques

La IsBypassed méthode est utilisée pour déterminer s’il faut contourner le serveur proxy lors de l’accès à une ressource Internet.

Les BypassProxyOnLocal propriétés et BypassList contrôlent la valeur de retour de la IsBypassed méthode.

IsBypassed renvoie true dans l'une des conditions suivantes:

• Si BypassProxyOnLocal est true et host est un URI local. Les requêtes locales sont identifiées par l’absence d’un point (.) dans l’URI, comme dans http://webserver/.

• Si host correspond à une expression régulière dans BypassList.

• Si Address est null.

Toutes les autres conditions retournent false.