WebProxy.IsBypassed(Uri) Метод
В этой статье
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Показывает, используется ли данный прокси-сервер для заданного узла.
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
Значение true
, если прокси-сервер не должен использоваться для host
; в противном случае — false
.
Параметр host
имеет значение null
.
В следующем примере кода создается WebProxy объект и вызывается этот метод для проверки правильности задания списка обхода.
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;
}
}
Метод IsBypassed используется для определения того, следует ли обходить прокси-сервер при доступе к интернет-ресурсу.
Свойства BypassProxyOnLocal и BypassList управляют возвращаемым значением IsBypassed метода .
IsBypassed возвращается true
при любом из следующих условий:
Если BypassProxyOnLocal имеет значение
true
иhost
является локальным универсальным кодом ресурса (URI). Локальные запросы определяются отсутствием точки (.) в URI, как вhttp://webserver/
.Если
host
соответствует регулярному выражению в BypassList.Если Address имеет значение
null
.
Все остальные условия возвращают .false
Применяется к
Продукт | Версии |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |