You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/framework/network-programming/proxy-configuration.md
+4-26Lines changed: 4 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: "Proxy Configuration"
3
-
ms.date: "03/30/2017"
3
+
ms.date: "06/18/2018"
4
4
helpviewer_keywords:
5
5
- "Networking"
6
6
- "adaptive proxies"
@@ -23,38 +23,16 @@ A proxy server handles client requests for resources. A proxy can return a reque
23
23
24
24
Adaptive proxies are configured by a configuration script (see [Automatic Proxy Detection](../../../docs/framework/network-programming/automatic-proxy-detection.md)). The script generates a set of application protocols and a proxy for each protocol.
25
25
26
-
Several options control how the configuration script is run. You can specify the following:
27
-
28
-
- How often the configuration script is downloaded and run.
29
-
30
-
- How long to wait for the script to download.
31
-
32
-
- Which credentials your system should use to access the proxy.
33
-
34
-
- Which credentials your system should use to download the configuration script.
35
-
36
26
Changes in the network environment may require that the system use a new set of proxies. If a network connection goes down or a new network connection is initialized, the system must discover the appropriate source of the configuration script in the new environment and run the new script.
37
27
38
-
The following table shows configuration options for an adaptive proxy.
39
-
40
-
|Attribute, property, or configuration file setting|Description|
|`scriptDownloadInterval`|Elapsed time in seconds between script downloads.|
43
-
|`scriptDownloadTimeout`|Time to wait (in seconds) for the script to download.|
44
-
|`useDefaultCredentials` or <xref:System.Net.WebProxy.UseDefaultCredentials>|Controls whether the system uses the default network credentials to access a proxy.|
45
-
|`useDefaultCredentialForScriptDownload`|Controls whether the system uses the default network credentials to download the configuration script.|
46
-
|`usesystemdefaults`|Controls whether the static proxy settings (proxy address, bypass list, and bypass on local) should be read from the Internet Explorer proxy settings for the user. If this value is set to "true", then the static proxy settings from Internet Explorer will be used.<br /><br /> If this value is "false" or not set, then the static proxy settings can be specified in the configuration and will override the Internet Explorer proxy settings. This value must also be set to "false" or not set for adaptive proxies to be enabled.|
28
+
You can use the `usesystemdefault` attribute of the [`<proxy>`](../configure-apps/file-schema/network/proxy-element-network-settings.md) element in your configuration file. The `usesystemdefault` attribute controls whether the static proxy settings (proxy address, bypass list, and bypass on local) should be read from the Internet Explorer proxy settings for the user. If this value is set to `true`, the static proxy settings from Internet Explorer will be used. If this value is `false` or not set, the static proxy settings can be specified in the configuration and will override the Internet Explorer proxy settings. This value must also be set to `false` or not set for adaptive proxies to be enabled.
47
29
48
30
The following example shows a typical adaptive proxy configuration.
49
31
50
32
```xml
51
33
<system.net>
52
34
<defaultProxy>
53
-
<proxyscriptDownloadInterval="600"
54
-
scriptDownloadTimeout="30"
55
-
useDefaultCredentials="true"
56
-
usesystemdefaults="true"
57
-
/>
35
+
<proxyusesystemdefault="false" />
58
36
</defaultProxy>
59
37
</system.net>
60
38
```
@@ -77,7 +55,7 @@ A proxy server handles client requests for resources. A proxy can return a reque
77
55
|`proxyaddress` or <xref:System.Net.WebProxy.Address>|The address of the proxy to use.|
78
56
|`bypassonlocal` or <xref:System.Net.WebProxy.BypassProxyOnLocal>|Controls whether the proxy is bypassed for local addresses.|
79
57
|`bypasslist` or <xref:System.Net.WebProxy.BypassArrayList>|Describes, with regular expressions, a set of addresses that bypass the proxy.|
80
-
|`usesystemdefaults`|Controls whether the static proxy settings (proxy address, bypass list, and bypass on local) should be read from the Internet Explorer proxy settings for the user. If this value is set to "true", then the static proxy settings from Internet Explorer will be used. On .NET Framework 2.0 when this value is set to "true", the Internet Explorer proxy settings are not overridden by other proxy settings in the configuration file. On .NET Framework 1.1, the Internet Explorer proxy settings can be overridden by other proxy settings in the configuration file.<br /><br /> If this value is "false" or not set, then the static proxy settings can be specified in the configuration and will override the Internet Explorer proxy settings. This value must also be set to "false" or not set for adaptive proxies to be enabled.|
58
+
|`usesystemdefault`|Controls whether the static proxy settings (proxy address, bypass list, and bypass on local) should be read from the Internet Explorer proxy settings for the user. If this value is set to `true`, then the static proxy settings from Internet Explorer will be used. On .NET Framework 2.0 when this value is set to `true`, the Internet Explorer proxy settings are not overridden by other proxy settings in the configuration file. On .NET Framework 1.1, the Internet Explorer proxy settings can be overridden by other proxy settings in the configuration file.<br /><br /> If this value is `false` or not set, then the static proxy settings can be specified in the configuration and will override the Internet Explorer proxy settings. This value must also be set to `false` or not set for adaptive proxies to be enabled.|
81
59
82
60
The following example shows a typical static proxy configuration.
0 commit comments