WebProxy.IsBypassed(Uri) Methode

Definition

Namespace:

System.Net

Assemblys:

netstandard.dll, System.Net.WebProxy.dll

Quelle:

WebProxy.cs

Gibt an, ob der Proxyserver für den angegebenen Host verwendet werden soll.

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

Parameter

host

Uri

Die Uri-Instanz des Hosts, der auf eine Proxyverwendung überprüft werden soll.

Gibt zurück

Boolean

true, wenn der Proxyserver nicht für host verwendet werden soll, andernfalls false.

Implementiert

IsBypassed(Uri)

Ausnahmen

ArgumentNullException

Der host-Parameter ist null.

Beispiele

Im folgenden Codebeispiel wird ein WebProxy -Objekt erstellt und diese Methode aufgerufen, um zu überprüfen, ob die Umgehungsliste ordnungsgemäß festgelegt ist.

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;
    }
}

Hinweise

Die IsBypassed -Methode wird verwendet, um zu bestimmen, ob der Proxyserver beim Zugriff auf eine Internetressource umgangen werden soll.

Die BypassProxyOnLocal Eigenschaften und BypassList steuern den Rückgabewert der IsBypassed -Methode.

IsBypassed gibt unter einer der folgenden Bedingungen zurück true :

• Wenn BypassProxyOnLocal ist true und host ein lokaler URI ist. Lokale Anforderungen werden durch das Fehlen eines Punkts (.) im URI identifiziert, wie in http://webserver/.

• Wenn host mit einem regulären Ausdruck in BypassListübereinstimmt.

• Wenn Address gleich null ist.

Alle anderen Bedingungen geben zurück false.