WebProxy.IsBypassed(Uri) Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebProxy.dll

Ensamblado:

System.dll

Ensamblado:

netstandard.dll

Indica si se va a usar el servidor proxy para el host especificado.

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

Parámetros

host

Uri

La instancia de Uri del host que se comprobará para el uso del proxy.

Devoluciones

Boolean

Es true si el servidor proxy no se debe utilizar para host; de lo contrario, es false.

Implementaciones

IsBypassed(Uri)

Excepciones

ArgumentNullException

El parámetro host es null.

Ejemplos

En el ejemplo de código siguiente se crea un WebProxy objeto y se llama a este método para comprobar si la lista de omisión está establecida correctamente.

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

Comentarios

El IsBypassed método se usa para determinar si se omite el servidor proxy al acceder a un recurso de Internet.

Las BypassProxyOnLocal propiedades y BypassList controlan el valor devuelto del IsBypassed método .

IsBypassed devuelve true en cualquiera de las condiciones siguientes:

• Si BypassProxyOnLocal es true y host es un URI local. Las solicitudes locales se identifican por la falta de un punto (.) en el URI, como en http://webserver/.

• Si host coincide con una expresión regular en BypassList.

• Si Address es null.

Todas las demás condiciones devuelven false.