remove references to IE where possible (#8943)

gewarren · web-flow · commit d73e8d9fd270 · 2024-05-08T11:07:32.000-07:00
diff --git a/xml/System.Net.Configuration/ProxyElement.xml b/xml/System.Net.Configuration/ProxyElement.xml
@@ -22,11 +22,11 @@
 ## Remarks  
  The following table shows the configuration attributes of the [&lt;proxy&gt; Element (Network Settings)](/dotnet/framework/configure-apps/file-schema/network/proxy-element-network-settings) configuration element to which this class corresponds.  
   
-|Element|Description|  
-|-------------|-----------------|  
-|`proxyaddress`|A URI that identifies the Web proxy server to use.|  
-|`bypassonlocal`|Determines whether the Web proxy is bypassed for local resources.|  
-|`usesystemdefault`|Controls whether the Internet Explorer Web proxy settings are used.|  
+| Element            | Description                                                        |
+| ------------------ | ------------------------------------------------------------------ |
+| `proxyaddress`     | A URI that identifies the Web proxy server to use.                 |
+| `bypassonlocal`    | Determines whether the Web proxy is bypassed for local resources.  |
+| `usesystemdefault` | Controls whether the Internet options Web proxy settings are used. |
   
  This class is used to specify and configure the Web proxy server to use for requests made with the <xref:System.Net.WebRequest> and <xref:System.Net.WebClient> classes.  
   
@@ -239,9 +239,9 @@
         <ReturnType>System.Net.Configuration.ProxyElement+UseSystemDefaultValues</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets a <see cref="T:System.Boolean" /> value that controls whether the Internet Explorer Web proxy settings are used.</summary>
+        <summary>Gets or sets a value that controls whether the Internet options Web proxy settings are used.</summary>
         <value>
-          <see langword="true" /> if the Internet Explorer LAN settings are used to detect and configure the default <see cref="T:System.Net.WebProxy" /> used for requests; otherwise, <see langword="false" />.</value>
+          <see langword="true" /> if the Internet options LAN settings are used to detect and configure the default <see cref="T:System.Net.WebProxy" /> used for requests; otherwise, <see langword="false" />.</value>
         <remarks>To be added.</remarks>
         <altmember cref="T:System.Net.WebProxy" />
         <related type="Article" href="/dotnet/framework/configure-apps/file-schema/network/">Network Settings Schema</related>
diff --git a/xml/System.Net.Http/HttpClientHandler.xml b/xml/System.Net.Http/HttpClientHandler.xml
@@ -1001,17 +1001,13 @@ handler.ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousA
 ## Remarks
  The <xref:System.Net.Http.HttpClientHandler.Proxy%2A> property identifies the <xref:System.Net.WebProxy> object to use to process requests to Internet resources. To specify that no proxy should be used, set the <xref:System.Net.Http.HttpClientHandler.Proxy%2A> property to the proxy instance returned by the <xref:System.Net.GlobalProxySelection.GetEmptyWebProxy%2A> method.
 
- The local computer or application config file may specify that a default proxy be used. If the <xref:System.Net.Http.HttpClientHandler.Proxy%2A> property is specified, then the proxy settings from the <xref:System.Net.Http.HttpClientHandler.Proxy%2A> property override the local computer or application config file and the handler will use the proxy settings specified. If no proxy is specified in a config file and the <xref:System.Net.Http.HttpClientHandler.Proxy%2A> property is unspecified, the handler uses the proxy settings inherited from Internet Explorer on the local computer. If there are no proxy settings in Internet Explorer, the request is sent directly to the server.
-
- The <xref:System.Net.Http.HttpClientHandler> class parses a proxy bypass list with wildcard characters inherited from Internet Explorer the same as the bypass list is parsed directly by Internet Explorer. For example, the <xref:System.Net.Http.HttpClientHandler> class will parse a bypass list of "nt*" from Internet Explorer as a regular expression of "nt.\*". So a URL of `http://nt.com` would bypass the proxy using the <xref:System.Net.Http.HttpClientHandler> class and using Internet Explorer.
+ The local computer or application config file may specify that a default proxy be used. If the <xref:System.Net.Http.HttpClientHandler.Proxy%2A> property is specified, then the proxy settings from the <xref:System.Net.Http.HttpClientHandler.Proxy%2A> property override the local computer or application config file and the handler will use the proxy settings specified. If no proxy is specified in a config file and the <xref:System.Net.Http.HttpClientHandler.Proxy%2A> property is unspecified, the handler uses the proxy settings inherited from Internet options on the local computer. If there are no proxy settings in Internet options, the request is sent directly to the server.
 
  The <xref:System.Net.Http.HttpClientHandler> class supports local proxy bypass. The class considers a destination to be local if any of the following conditions are met:
 
-1.  The destination contains a flat name (no dots in the URL).
-
-2.  The destination contains a loopback address (<xref:System.Net.IPAddress.Loopback> or <xref:System.Net.IPAddress.IPv6Loopback>) or the destination contains an <xref:System.Net.IPAddress> assigned to the local computer.
-
-3.  The domain suffix of the destination matches the local computer's domain suffix (<xref:System.Net.NetworkInformation.IPGlobalProperties.DomainName%2A>).
+- The destination contains a flat name (no dots in the URL).
+- The destination contains a loopback address (<xref:System.Net.IPAddress.Loopback> or <xref:System.Net.IPAddress.IPv6Loopback>) or the destination contains an <xref:System.Net.IPAddress> assigned to the local computer.
+- The domain suffix of the destination matches the local computer's domain suffix (<xref:System.Net.NetworkInformation.IPGlobalProperties.DomainName%2A>).
 
  ]]></format>
         </remarks>
diff --git a/xml/System.Net.Http/WindowsProxyUsePolicy.xml b/xml/System.Net.Http/WindowsProxyUsePolicy.xml
@@ -137,7 +137,7 @@
       </ReturnValue>
       <MemberValue>2</MemberValue>
       <Docs>
-        <summary>This value indicates that the current proxy configuration of the WinINet API on the machine is used. The proxy settings can be configured using the Internet Explorer Options and supports WPAD and PAC files.</summary>
+        <summary>This value indicates that the current proxy configuration of the WinINet API on the machine is used. The proxy settings can be configured using Internet options and supports WPAD and PAC files.</summary>
       </Docs>
     </Member>
   </Members>
diff --git a/xml/System.Net/HttpWebRequest.xml b/xml/System.Net/HttpWebRequest.xml
@@ -78,7 +78,7 @@
 ## Remarks
 
 > [!IMPORTANT]
->  We don't recommend that you use `HttpWebRequest` for new development. Instead, use the <xref:System.Net.Http.HttpClient?displayProperty=nameWithType> class.
+> We recommend that you don't use `HttpWebRequest` for new development. Instead, use the <xref:System.Net.Http.HttpClient?displayProperty=nameWithType> class.
 
  The <xref:System.Net.HttpWebRequest> class provides support for the properties and methods defined in <xref:System.Net.WebRequest> and for additional properties and methods that enable the user to interact directly with servers using HTTP.
 
@@ -114,9 +114,7 @@
 > [!NOTE]
 >  <xref:System.Net.HttpWebRequest> is registered automatically. You do not need to call the <xref:System.Net.WebRequest.RegisterPrefix%2A> method to register <xref:System.Net.HttpWebRequest?displayProperty=nameWithType> before using URIs beginning with `http://` or `https://`.
 
- The local computer or application config file may specify that a default proxy be used. If the <xref:System.Net.HttpWebRequest.Proxy%2A> property is specified, then the proxy settings from the <xref:System.Net.HttpWebRequest.Proxy%2A> property override the local computer or application config file and the <xref:System.Net.HttpWebRequest> instance will use the proxy settings specified. If no proxy is specified in a config file and the <xref:System.Net.HttpWebRequest.Proxy%2A> property is unspecified, the <xref:System.Net.HttpWebRequest> class uses the proxy settings inherited from Internet Explorer on the local computer. If there are no proxy settings in Internet Explorer, the request is sent directly to the server.
-
- The <xref:System.Net.HttpWebRequest> class parses a proxy bypass list with wildcard characters inherited from Internet Explorer differently than the bypass list is parsed directly by Internet Explorer. For example, the <xref:System.Net.HttpWebRequest> class will parse a bypass list of "nt*" from Internet Explorer as a regular expression of "nt.$". This differs from the native behavior of Internet Explorer. So a URL of "`http://intxxxxx`" would bypass the proxy using the <xref:System.Net.HttpWebRequest> class, but would not bypass the proxy using Internet Explorer.
+ The local computer or application config file may specify that a default proxy be used. If the <xref:System.Net.HttpWebRequest.Proxy%2A> property is specified, then the proxy settings from the <xref:System.Net.HttpWebRequest.Proxy%2A> property override the local computer or application config file and the <xref:System.Net.HttpWebRequest> instance will use the proxy settings specified. If no proxy is specified in a config file and the <xref:System.Net.HttpWebRequest.Proxy%2A> property is unspecified, the <xref:System.Net.HttpWebRequest> class uses the proxy settings inherited from Internet options on the local computer. If there are no proxy settings in Internet options, the request is sent directly to the server.
 
 > [!NOTE]
 >  The Framework caches SSL sessions as they are created and attempts to reuse a cached session for a new request, if possible. When attempting to reuse an SSL session, the Framework uses the first element of <xref:System.Net.HttpWebRequest.ClientCertificates%2A> (if there is one), or tries to reuse an anonymous sessions if <xref:System.Net.HttpWebRequest.ClientCertificates%2A> is empty.
@@ -4324,9 +4322,7 @@ The GetHashCode method returns a hash code of the web request. This value can be
 ## Remarks
  The <xref:System.Net.HttpWebRequest.Proxy%2A> property identifies the <xref:System.Net.WebProxy> object to use to process requests to Internet resources. To specify that no proxy should be used, set the <xref:System.Net.HttpWebRequest.Proxy%2A> property to the proxy instance returned by the <xref:System.Net.GlobalProxySelection.GetEmptyWebProxy%2A?displayProperty=nameWithType> method.
 
- The local computer or application config file may specify that a default proxy be used. If the <xref:System.Net.HttpWebRequest.Proxy%2A> property is specified, then the proxy settings from the <xref:System.Net.HttpWebRequest.Proxy%2A> property override the local computer or application config file and the <xref:System.Net.HttpWebRequest> instance will use the proxy settings specified. If no proxy is specified in a config file and the <xref:System.Net.HttpWebRequest.Proxy%2A> property is unspecified, the <xref:System.Net.HttpWebRequest> class uses the proxy settings inherited from Internet Explorer on the local computer. If there are no proxy settings in Internet Explorer, the request is sent directly to the server.
-
- The <xref:System.Net.HttpWebRequest> class parses a proxy bypass list with wildcard characters inherited from Internet Explorer the same as the bypass list is parsed directly by Internet Explorer. For example, the <xref:System.Net.HttpWebRequest> class will parse a bypass list of "nt*" from Internet Explorer as a regular expression of "nt.\*". So a URL of "`http://nt.com`" would bypass the proxy using the <xref:System.Net.HttpWebRequest> class and using Internet Explorer.
+ The local computer or application config file may specify that a default proxy be used. If the <xref:System.Net.HttpWebRequest.Proxy%2A> property is specified, then the proxy settings from the <xref:System.Net.HttpWebRequest.Proxy%2A> property override the local computer or application config file and the <xref:System.Net.HttpWebRequest> instance will use the proxy settings specified. If no proxy is specified in a config file and the <xref:System.Net.HttpWebRequest.Proxy%2A> property is unspecified, the <xref:System.Net.HttpWebRequest> class uses the proxy settings inherited from Internet options on the local computer. If there are no proxy settings in Internet options, the request is sent directly to the server.
 
  The <xref:System.Net.HttpWebRequest> class supports local proxy bypass. The class considers a destination to be local if any of the following conditions are met:
 
diff --git a/xml/System.Net/WebClient.xml b/xml/System.Net/WebClient.xml
@@ -5230,7 +5230,7 @@ internal class MyWebClient : WebClientProtocol
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- The <xref:System.Net.WebClient.Proxy%2A> property identifies the <xref:System.Net.IWebProxy> instance that communicates with remote servers on behalf of this <xref:System.Net.WebClient> object. The proxy is set by the system using configuration files and the Internet Explorer Local Area Network settings. To specify that no proxy should be used, set the <xref:System.Net.WebClient.Proxy%2A> property to `null`.
+ The <xref:System.Net.WebClient.Proxy%2A> property identifies the <xref:System.Net.IWebProxy> instance that communicates with remote servers on behalf of this <xref:System.Net.WebClient> object. The proxy is set by the system using configuration files and the Local Area Network settings. To specify that no proxy should be used, set the <xref:System.Net.WebClient.Proxy%2A> property to `null`.
 
  For information on automatic proxy detection, see [Automatic Proxy Detection](/dotnet/framework/network-programming/automatic-proxy-detection).
 
diff --git a/xml/System.Net/WebProxy.xml b/xml/System.Net/WebProxy.xml
@@ -82,9 +82,9 @@
   
  These methods each supply a <xref:System.Net.WebProxy> instance that you can further customize; the difference between them is how the instance is initialized before it is returned to your application. The <xref:System.Net.WebProxy.%23ctor%2A> constructor returns an instance of the <xref:System.Net.WebProxy> class with the <xref:System.Net.WebProxy.Address%2A> property set to `null`. When a request uses a <xref:System.Net.WebProxy> instance in this state, no proxy is used to send the request.  
   
- The <xref:System.Net.WebProxy.GetDefaultProxy%2A> method returns an instance of the <xref:System.Net.WebProxy> class with the <xref:System.Net.WebProxy.Address%2A>, <xref:System.Net.WebProxy.BypassProxyOnLocal%2A>, and <xref:System.Net.WebProxy.BypassList%2A> properties set to the values used by Internet Explorer 5.5 and later.  
+ The <xref:System.Net.WebProxy.GetDefaultProxy%2A> method returns an instance of the <xref:System.Net.WebProxy> class with the <xref:System.Net.WebProxy.Address%2A>, <xref:System.Net.WebProxy.BypassProxyOnLocal%2A>, and <xref:System.Net.WebProxy.BypassList%2A> properties set to the values used by the local computer.  
   
- The <xref:System.Net.GlobalProxySelection.Select%2A> method returns an instance of the <xref:System.Net.WebProxy> class with it properties set according to a combination of Internet Explorer and configuration file settings.  
+ The <xref:System.Net.GlobalProxySelection.Select%2A> method returns an instance of the <xref:System.Net.WebProxy> class with it properties set according to a combination of Internet and configuration file settings.  
   
  The <xref:System.Net.WebProxy> class supports automatic detection and execution of proxy configuration scripts. This feature is also known as Web Proxy Auto-Discovery (WPAD). When using automatic proxy configuration, a configuration script, typically named Wpad.dat, must be located, downloaded, compiled, and run. If these operations are successful, the script returns the proxies that can be used for a request.  
   
@@ -1215,13 +1215,13 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Reads the Internet Explorer nondynamic proxy settings.</summary>
-        <returns>A <see cref="T:System.Net.WebProxy" /> instance that contains the nondynamic proxy settings from Internet Explorer 5.5 and later.</returns>
+        <summary>Reads the Internet options nondynamic proxy settings.</summary>
+        <returns>A <see cref="T:System.Net.WebProxy" /> instance that contains the nondynamic proxy settings from Internet options.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
 ## Remarks  
- The <xref:System.Net.WebProxy.GetDefaultProxy%2A> method reads the nondynamic proxy settings stored by Internet Explorer 5.5 and later, and creates a <xref:System.Net.WebProxy> instance with those settings.  
+ The <xref:System.Net.WebProxy.GetDefaultProxy%2A> method reads the nondynamic proxy settings from the computer's Internet options and creates a <xref:System.Net.WebProxy> instance with those settings.  
   
  The <xref:System.Net.WebProxy.GetDefaultProxy%2A> method does not pick up any dynamic settings that are generated from scripts run by Internet Explorer, from automatic configuration entries, or from DHCP or DNS lookups.  
   
diff --git a/xml/System.Net/WebRequest.xml b/xml/System.Net/WebRequest.xml
@@ -1558,7 +1558,7 @@ This property allows an application to determine which <xref:System.Net.IWebRequ
 ## Remarks
  The <xref:System.Net.WebRequest.DefaultWebProxy%2A> property gets or sets the global proxy. The <xref:System.Net.WebRequest.DefaultWebProxy%2A> property determines the default proxy that all <xref:System.Net.WebRequest> instances use if the request supports proxies and no proxy is set explicitly using the <xref:System.Net.HttpWebRequest.Proxy%2A> property. Proxies are currently supported by <xref:System.Net.FtpWebRequest> and <xref:System.Net.HttpWebRequest>.
 
- The <xref:System.Net.WebRequest.DefaultWebProxy%2A> property reads proxy settings from the app.config file. If there is no config file, the current user's Internet Explorer (IE) proxy settings are used.
+ The <xref:System.Net.WebRequest.DefaultWebProxy%2A> property reads proxy settings from the app.config file. If there is no config file, the current user's Internet options proxy settings are used.
 
  If the <xref:System.Net.WebRequest.DefaultWebProxy%2A> property is set to null, all subsequent instances of the <xref:System.Net.WebRequest> class created by the <xref:System.Net.WebRequest.Create%2A> or <xref:System.Net.WebRequest.CreateDefault%2A> methods do not have a proxy.
 
@@ -2060,15 +2060,15 @@ This property allows an application to determine which <xref:System.Net.IWebRequ
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Returns a proxy configured with the Internet Explorer settings of the currently impersonated user.</summary>
+        <summary>Returns a proxy configured with the Internet options settings of the currently impersonated user.</summary>
         <returns>An <see cref="T:System.Net.IWebProxy" /> used by every call to instances of <see cref="T:System.Net.WebRequest" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- <xref:System.Net.WebRequest.GetSystemWebProxy%2A> method reads the current user's Internet Explorer (IE) proxy settings. This process includes the IE options to automatically detect proxy settings, use an automatic configuration script, manual proxy server settings, and advanced manual proxy server settings.
+ <xref:System.Net.WebRequest.GetSystemWebProxy%2A> method reads the current user's Internet options proxy settings. This process includes the options to automatically detect proxy settings, use an automatic configuration script, manual proxy server settings, and advanced manual proxy server settings.
 
- If your application is impersonating several users, you can use the <xref:System.Net.WebRequest.GetSystemWebProxy%2A> method to retrieve a proxy for each impersonated user.
+ If your application impersonates several users, you can use the <xref:System.Net.WebRequest.GetSystemWebProxy%2A> method to retrieve a proxy for each impersonated user.
 
  ]]></format>
         </remarks>
