WebProxy.IsBypassed(Uri) Methode

Definition

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

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

Implementiert

Ausnahmen

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.

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

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.

Gilt für: