1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.Net.WebProxy</name>
6 <member name="T:System.Net.IWebProxyScript">
7 <summary>Provides the base interface to load and execute scripts for automatic proxy detection.</summary>
9 <member name="M:System.Net.IWebProxyScript.Close">
10 <summary>Closes a script.</summary>
12 <member name="M:System.Net.IWebProxyScript.Load(System.Uri,System.String,System.Type)">
13 <summary>Loads a script.</summary>
14 <param name="scriptLocation">Internal only.</param>
15 <param name="script">Internal only.</param>
16 <param name="helperType">Internal only.</param>
17 <returns>A <see cref="System.Boolean"></see> indicating whether the script was successfully loaded.</returns>
19 <member name="M:System.Net.IWebProxyScript.Run(System.String,System.String)">
20 <summary>Runs a script.</summary>
21 <param name="url">Internal only.</param>
22 <param name="host">Internal only.</param>
23 <returns>A <see cref="System.String"></see>.
24 An internal-only value returned.</returns>
26 <member name="T:System.Net.WebProxy">
27 <summary>Contains HTTP proxy settings for the <see cref="T:System.Net.WebRequest"></see> class.</summary>
29 <member name="M:System.Net.WebProxy.#ctor">
30 <summary>Initializes an empty instance of the <see cref="T:System.Net.WebProxy"></see> class.</summary>
32 <member name="M:System.Net.WebProxy.#ctor(System.String)">
33 <summary>Initializes a new instance of the <see cref="T:System.Net.WebProxy"></see> class with the specified URI.</summary>
34 <param name="Address">The URI of the proxy server.</param>
35 <exception cref="T:System.UriFormatException"><paramref name="Address">Address</paramref> is an invalid URI.</exception>
37 <member name="M:System.Net.WebProxy.#ctor(System.Uri)">
38 <summary>Initializes a new instance of the <see cref="T:System.Net.WebProxy"></see> class from the specified <see cref="T:System.Uri"></see> instance.</summary>
39 <param name="Address">A <see cref="T:System.Uri"></see> instance that contains the address of the proxy server.</param>
41 <member name="M:System.Net.WebProxy.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
42 <summary>Initializes an instance of the <see cref="T:System.Net.WebProxy"></see> class using previously serialized content.</summary>
43 <param name="serializationInfo">The serialization data.</param>
44 <param name="streamingContext">The context for the serialized data.</param>
46 <member name="M:System.Net.WebProxy.#ctor(System.String,System.Boolean)">
47 <summary>Initializes a new instance of the <see cref="T:System.Net.WebProxy"></see> class with the specified URI and bypass setting.</summary>
48 <param name="Address">The URI of the proxy server.</param>
49 <param name="BypassOnLocal">true to bypass the proxy for local addresses; otherwise, false.</param>
50 <exception cref="T:System.UriFormatException"><paramref name="Address">Address</paramref> is an invalid URI.</exception>
52 <member name="M:System.Net.WebProxy.#ctor(System.String,System.Int32)">
53 <summary>Initializes a new instance of the <see cref="T:System.Net.WebProxy"></see> class with the specified host and port number.</summary>
54 <param name="Host">The name of the proxy host.</param>
55 <param name="Port">The port number on Host to use.</param>
56 <exception cref="T:System.UriFormatException">The URI formed by combining <paramref name="Host">Host</paramref> and <paramref name="Port">Port</paramref> is not a valid URI.</exception>
58 <member name="M:System.Net.WebProxy.#ctor(System.Uri,System.Boolean)">
59 <summary>Initializes a new instance of the <see cref="T:System.Net.WebProxy"></see> class with the <see cref="T:System.Uri"></see> instance and bypass setting.</summary>
60 <param name="Address">A <see cref="T:System.Uri"></see> instance that contains the address of the proxy server.</param>
61 <param name="BypassOnLocal">true to bypass the proxy for local addresses; otherwise, false.</param>
63 <member name="M:System.Net.WebProxy.#ctor(System.String,System.Boolean,System.String[])">
64 <summary>Initializes a new instance of the <see cref="T:System.Net.WebProxy"></see> class with the specified URI, bypass setting, and list of URIs to bypass.</summary>
65 <param name="Address">The URI of the proxy server.</param>
66 <param name="BypassOnLocal">true to bypass the proxy for local addresses; otherwise, false.</param>
67 <param name="BypassList">An array of regular expression strings that contain the URIs of the servers to bypass.</param>
68 <exception cref="T:System.UriFormatException"><paramref name="Address">Address</paramref> is an invalid URI.</exception>
70 <member name="M:System.Net.WebProxy.#ctor(System.Uri,System.Boolean,System.String[])">
71 <summary>Initializes a new instance of the <see cref="T:System.Net.WebProxy"></see> class with the specified <see cref="T:System.Uri"></see> instance, bypass setting, and list of URIs to bypass.</summary>
72 <param name="Address">A <see cref="T:System.Uri"></see> instance that contains the address of the proxy server.</param>
73 <param name="BypassOnLocal">true to bypass the proxy for local addresses; otherwise, false.</param>
74 <param name="BypassList">An array of regular expression strings that contains the URIs of the servers to bypass.</param>
76 <member name="M:System.Net.WebProxy.#ctor(System.String,System.Boolean,System.String[],System.Net.ICredentials)">
77 <summary>Initializes a new instance of the <see cref="T:System.Net.WebProxy"></see> class with the specified URI, bypass setting, list of URIs to bypass, and credentials.</summary>
78 <param name="Address">The URI of the proxy server.</param>
79 <param name="BypassOnLocal">true to bypass the proxy for local addresses; otherwise, false.</param>
80 <param name="BypassList">An array of regular expression strings that contains the URIs of the servers to bypass.</param>
81 <param name="Credentials">An <see cref="T:System.Net.ICredentials"></see> instance to submit to the proxy server for authentication.</param>
82 <exception cref="T:System.UriFormatException"><paramref name="Address">Address</paramref> is an invalid URI.</exception>
84 <member name="M:System.Net.WebProxy.#ctor(System.Uri,System.Boolean,System.String[],System.Net.ICredentials)">
85 <summary>Initializes a new instance of the <see cref="T:System.Net.WebProxy"></see> class with the specified <see cref="T:System.Uri"></see> instance, bypass setting, list of URIs to bypass, and credentials.</summary>
86 <param name="Address">A <see cref="T:System.Uri"></see> instance that contains the address of the proxy server.</param>
87 <param name="BypassOnLocal">true to bypass the proxy for local addresses; otherwise, false.</param>
88 <param name="BypassList">An array of regular expression strings that contains the URIs of the servers to bypass.</param>
89 <param name="Credentials">An <see cref="T:System.Net.ICredentials"></see> instance to submit to the proxy server for authentication.</param>
91 <member name="P:System.Net.WebProxy.Address">
92 <summary>Gets or sets the address of the proxy server.</summary>
93 <returns>A <see cref="System.Uri"></see> instance that contains the address of the proxy server.</returns>
95 <member name="P:System.Net.WebProxy.BypassArrayList">
96 <summary>Gets a list of addresses that do not use the proxy server.</summary>
97 <returns>An <see cref="System.Collections.ArrayList"></see> that contains a list of <see cref="System.Net.WebProxy.BypassList"></see> arrays that represents URIs that do not use the proxy server when accessed.</returns>
99 <member name="P:System.Net.WebProxy.BypassList">
100 <summary>Gets or sets an array of addresses that do not use the proxy server.</summary>
101 <returns>An array that contains a list of regular expressions that describe URIs that do not use the proxy server when accessed.</returns>
103 <member name="P:System.Net.WebProxy.BypassProxyOnLocal">
104 <summary>Gets or sets a value that indicates whether to bypass the proxy server for local addresses.</summary>
105 <returns>true to bypass the proxy server for local addresses; otherwise, false. The default value is false.</returns>
107 <member name="P:System.Net.WebProxy.Credentials">
108 <summary>Gets or sets the credentials to submit to the proxy server for authentication.</summary>
109 <returns>An <see cref="System.Net.ICredentials"></see> instance that contains the credentials to submit to the proxy server for authentication.</returns>
110 <exception cref="T:System.InvalidOperationException">You attempted to set this property when the <see cref="System.Net.WebProxy.UseDefaultCredentials"></see> property was set to true.</exception>
112 <member name="M:System.Net.WebProxy.GetDefaultProxy">
113 <summary>Reads the Internet Explorer nondynamic proxy settings.</summary>
114 <returns>A <see cref="System.Net.WebProxy"></see> instance that contains the nondynamic proxy settings from Internet Explorer 5.5 and later.</returns>
116 <member name="M:System.Net.WebProxy.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
117 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> with the data that is needed to serialize the target object.</summary>
118 <param name="serializationInfo">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to populate with data.</param>
119 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that specifies the destination for this serialization.</param>
121 <member name="M:System.Net.WebProxy.GetProxy(System.Uri)">
122 <summary>Returns the proxied URI for a request.</summary>
123 <param name="destination">The <see cref="T:System.Uri"></see> instance of the requested Internet resource.</param>
124 <returns>The <see cref="System.Uri"></see> instance of the Internet resource, if the resource is on the bypass list; otherwise, the <see cref="System.Uri"></see> instance of the proxy.</returns>
125 <exception cref="T:System.ArgumentNullException">The <paramref name="destination">destination</paramref> parameter is null.</exception>
127 <member name="M:System.Net.WebProxy.IsBypassed(System.Uri)">
128 <summary>Indicates whether to use the proxy server for the specified host.</summary>
129 <param name="host">The <see cref="T:System.Uri"></see> instance of the host to check for proxy use.</param>
130 <returns>true if the proxy server should not be used for <paramref name="host">host</paramref>; otherwise, false.</returns>
131 <exception cref="T:System.ArgumentNullException">The <paramref name="host">host</paramref> parameter is null.</exception>
133 <member name="P:System.Net.WebProxy.UseDefaultCredentials">
134 <summary>Gets or sets a <see cref="T:System.Boolean"></see> value that controls whether the <see cref="P:System.Net.CredentialCache.DefaultCredentials"></see> are sent with requests.</summary>
135 <returns>true if the default credentials are used; otherwise, false. The default value is false.</returns>
136 <exception cref="T:System.InvalidOperationException">You attempted to set this property when the <see cref="System.Net.WebProxy.Credentials"></see> property contains credentials other than the default credentials.</exception>
138 <member name="M:System.Net.WebProxy.System#Runtime#Serialization#ISerializable#GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
139 <summary>Creates the serialization data and context that are used by the system to serialize a <see cref="T:System.Net.WebProxy"></see> object.</summary>
140 <param name="serializationInfo">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object to populate with data.</param>
141 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> structure that indicates the destination for this serialization.</param>