WebProxy.GetProxy(Uri) Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebProxy.dll

Zdroj:

WebProxy.cs

Vrátí identifikátor URI proxy pro požadavek.

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

Parametry

destination

Uri

Instance Uri požadovaného internetového prostředku.

Návraty

Uri

Instance Uri internetového prostředku, pokud je prostředek v seznamu vynechaných prostředků; Uri v opačném případě instance proxy serveru.

Implementuje

GetProxy(Uri)

Výjimky

ArgumentNullException

Parametr destination je null.

Příklady

Následující příklad kódu vytvoří WebProxy objekt a zavolá tuto metodu k získání proxy serveru vybraného pro prostředek.

// 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());
    }
}

Poznámky

Metoda GetProxy vrátí identifikátor URI, který HttpClient instance používá pro přístup k internetovému prostředku.

GetProxy destination porovná s obsahem souboru BypassListpomocí IsBypassed metody . Pokud IsBypassed vrátí truehodnotu , GetProxy vrátí destination hodnotu a HttpClient instance nepoužívá proxy server.

Pokud destination není v BypassList, HttpClient instance použije proxy server a Address vrátí se vlastnost .