Skip to content

Commit d3d469c

Browse files
author
Ron Petrusha
authored
Removed unsupported configuration attributes (#5958)
* Removed unsupported configuration attributes * Incorporated feedback * Additional correction
1 parent c0c8625 commit d3d469c

File tree

1 file changed

+4
-26
lines changed

1 file changed

+4
-26
lines changed

docs/framework/network-programming/proxy-configuration.md

Lines changed: 4 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Proxy Configuration"
3-
ms.date: "03/30/2017"
3+
ms.date: "06/18/2018"
44
helpviewer_keywords:
55
- "Networking"
66
- "adaptive proxies"
@@ -23,38 +23,16 @@ A proxy server handles client requests for resources. A proxy can return a reque
2323

2424
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.
2525

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-
3626
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.
3727

38-
The following table shows configuration options for an adaptive proxy.
39-
40-
|Attribute, property, or configuration file setting|Description|
41-
|--------------------------------------------------------|-----------------|
42-
|`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.
4729

4830
The following example shows a typical adaptive proxy configuration.
4931

5032
```xml
5133
<system.net>
5234
<defaultProxy>
53-
<proxy scriptDownloadInterval="600"
54-
scriptDownloadTimeout="30"
55-
useDefaultCredentials="true"
56-
usesystemdefaults="true"
57-
/>
35+
<proxy usesystemdefault="false" />
5836
</defaultProxy>
5937
</system.net>
6038
```
@@ -77,7 +55,7 @@ A proxy server handles client requests for resources. A proxy can return a reque
7755
|`proxyaddress` or <xref:System.Net.WebProxy.Address>|The address of the proxy to use.|
7856
|`bypassonlocal` or <xref:System.Net.WebProxy.BypassProxyOnLocal>|Controls whether the proxy is bypassed for local addresses.|
7957
|`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.|
8159

8260
The following example shows a typical static proxy configuration.
8361

0 commit comments

Comments
 (0)