WebProxy.IsBypassed(Uri) Methode

Referenz

Definition

Namespace:: System.Net

Assembly:: System.Net.WebProxy.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: WebProxy.cs

Quelle:: WebProxy.cs

Quelle:: WebProxy.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

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:

Freigeben über