WebProxy.BypassProxyOnLocal Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets a value that indicates whether to bypass the proxy server for local addresses.
public:
property bool BypassProxyOnLocal { bool get(); void set(bool value); };public bool BypassProxyOnLocal { get; set; }member this.BypassProxyOnLocal : bool with get, setPublic Property BypassProxyOnLocal As BooleanProperty Value
true to bypass the proxy server for local addresses; otherwise, false. The default value is false.
Examples
The following code example demonstrates calling a constructor that sets this property and getting the value of this property.
WebProxy^ CreateProxyWithHostAddress( bool bypassLocal )
{
WebProxy^ proxy = gcnew WebProxy( "http://contoso",bypassLocal );
Console::WriteLine( "Bypass proxy for local URIs?: {0}",
proxy->BypassProxyOnLocal );
return proxy;
}
public static WebProxy CreateProxyWithHostAddress(bool bypassLocal)
{
WebProxy proxy = new WebProxy("http://contoso", bypassLocal);
Console.WriteLine("Bypass proxy for local URIs?: {0}",
proxy.BypassProxyOnLocal);
return proxy;
}
Remarks
The setting of the BypassProxyOnLocal property determines whether to use the proxy server when accessing local Internet resources.
If BypassProxyOnLocal is true, requests to local Internet resources do not use the proxy server. Local requests are identified by the lack of a period (.) in the URI, as in http://webserver/, or access the local server, including http://localhost, http://loopback, or http://127.0.0.1. When BypassProxyOnLocal is false, all Internet requests are made through the proxy server.
Note
Requests to a local host with a URI that contain a period use the proxy. To avoid using a proxy in these cases, create an entry for the host in the BypassList.
