WebProxy.GetProxy(Uri) Метод

Определение

Пространство имен:

System.Net

Сборка:

System.Net.WebProxy.dll

Исходный код:

WebProxy.cs

Возвращает URI, использующий прокси-сервер, для запроса.

public:
 virtual Uri ^ GetProxy(Uri ^ destination);

public Uri? GetProxy (Uri destination);

abstract member GetProxy : Uri -> Uri
override this.GetProxy : Uri -> Uri

Public Function GetProxy (destination As Uri) As Uri

Параметры

destination

Uri

Экземпляр Uri запрошенного интернет-ресурса.

Возвращаемое значение

Uri

Экземпляр Uri интернет-ресурса, если этот ресурс находится в списке пропускаемых адресов, в противном случае — экземпляр Uri прокси-сервера.

Реализации

GetProxy(Uri)

Исключения

ArgumentNullException

Параметр destination имеет значение null.

Примеры

В следующем примере кода создается WebProxy объект и вызывается этот метод для получения прокси-сервера, выбранного для ресурса.

// The following method creates a WebProxy object that uses Internet Explorer's  
// detected script if it is found in the registry; otherwise, it 
// tries to use Web proxy auto-discovery to set the proxy used for
// the request.
void CheckAutoGlobalProxyForRequest( Uri^ resource )
{
   WebProxy^ proxy = gcnew WebProxy;
   
   // Display the proxy's properties.
   DisplayProxyProperties( proxy );
   
   // See what proxy is used for the resource.
   Uri^ resourceProxy = proxy->GetProxy( resource );
   
   // Test to see whether a proxy was selected.
   if ( resourceProxy == resource )
   {
      Console::WriteLine( "No proxy for {0}", resource );
   }
   else
   {
      Console::WriteLine( "Proxy for {0} is {1}", resource, resourceProxy );
   }
}

// The following method creates a WebProxy object that uses Internet Explorer's
// detected script if it is found in the registry; otherwise, it
// tries to use Web proxy auto-discovery to set the proxy used for
// the request.

public static void CheckAutoGlobalProxyForRequest(Uri resource)
{
    WebProxy proxy = new WebProxy();

    // Display the proxy's properties.
    DisplayProxyProperties(proxy);

    // See what proxy is used for the resource.
    Uri resourceProxy = proxy.GetProxy(resource);

    // Test to see whether a proxy was selected.
    if (resourceProxy == resource)
    {
        Console.WriteLine("No proxy for {0}", resource);
    }
    else
    {
        Console.WriteLine("Proxy for {0} is {1}", resource.OriginalString,
            resourceProxy.ToString());
    }
}

Комментарии

Метод GetProxy возвращает универсальный код ресурса (URI), который HttpClient экземпляр использует для доступа к интернет-ресурсу.

GetProxy Сравнивает destination с содержимым BypassList, используя IsBypassed метод . Если IsBypassed возвращает trueзначение , GetProxy возвращается destination , а HttpClient экземпляр не использует прокси-сервер.

Если destination значение не находится в BypassList, HttpClient экземпляр использует прокси-сервер и Address возвращается свойство .