WebProxy.IsBypassed(Uri) Méthode

Définition

Espace de noms:
System.Net
Assembly:
System.dll
Assembly:
netstandard.dll

Indique s’il faut utiliser le serveur proxy 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 Uri de l’hôte à vérifier l’utilisation du proxy.

Retours

Boolean

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

Implémente

IsBypassed(Uri)

Exceptions

ArgumentNullException

Le host paramètre est 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.

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 contrôlent BypassList la valeur de retour de la IsBypassed méthode.

IsBypassed retourne true dans l’une des conditions suivantes :

  • S’il BypassProxyOnLocal s’agit d’un truehost URI local. Les requêtes locales sont identifiées par l’absence d’une période (.) dans l’URI, comme dans http://webserver/.

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

  • Si Address c’est null.

Toutes les autres conditions retournent false.

S’applique à