WebProxy.IsBypassed(Uri) Méthode

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

Retours

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

Implémente

Exceptions

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.

S’applique à