WebProxy.IsBypassed(Uri) Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebProxy.dll

Origine:

WebProxy.cs

Indica se utilizzare il server proxy per l'host specificato.

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

Parametri

host

Uri

Istanza di Uri dell'host di cui verificare l'utilizzo del proxy.

Restituisce

Boolean

true se il server proxy non deve essere utilizzato per host. In caso contrario, false.

Implementazioni

IsBypassed(Uri)

Eccezioni

ArgumentNullException

Il valore del parametro host è null.

Esempio

Nell'esempio di codice seguente viene creato un WebProxy oggetto e viene chiamato questo metodo per verificare se l'elenco di bypass è impostato correttamente.

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

Commenti

Il IsBypassed metodo viene usato per determinare se ignorare il server proxy quando si accede a una risorsa Internet.

Le BypassProxyOnLocal proprietà e BypassList controllano il valore restituito del IsBypassed metodo .

IsBypassed restituisce true in una delle condizioni seguenti:

• Se BypassProxyOnLocal è true e host è un URI locale. Le richieste locali vengono identificate dalla mancanza di un punto (.) nell'URI, come in http://webserver/.

• Se host corrisponde a un'espressione regolare in BypassList.

• Se Address è null.

Tutte le altre condizioni restituiscono false.