1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.Net.Requests</name>
6 <member name="T:System.Net.WebResponse">
7 <summary>Provides a response from a Uniform Resource Identifier (URI). This is an <see langword="abstract"></see> class.</summary>
9 <member name="M:System.Net.WebResponse.#ctor">
10 <summary>Initializes a new instance of the <see cref="T:System.Net.WebResponse"></see> class.</summary>
12 <member name="M:System.Net.WebResponse.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
13 <summary>Initializes a new instance of the <see cref="T:System.Net.WebResponse"></see> class from the specified instances of the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> classes.</summary>
14 <param name="serializationInfo">An instance of the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> class that contains the information required to serialize the new <see cref="T:System.Net.WebRequest"></see> instance.</param>
15 <param name="streamingContext">An instance of the <see cref="T:System.Runtime.Serialization.StreamingContext"></see> class that indicates the source of the serialized stream that is associated with the new <see cref="T:System.Net.WebRequest"></see> instance.</param>
16 <exception cref="T:System.NotSupportedException">Any attempt is made to access the constructor, when the constructor is not overridden in a descendant class.</exception>
18 <member name="M:System.Net.WebResponse.Close">
19 <summary>When overridden by a descendant class, closes the response stream.</summary>
20 <exception cref="T:System.NotSupportedException">Any attempt is made to access the method, when the method is not overridden in a descendant class.</exception>
22 <member name="P:System.Net.WebResponse.ContentLength">
23 <summary>When overridden in a descendant class, gets or sets the content length of data being received.</summary>
24 <returns>The number of bytes returned from the Internet resource.</returns>
25 <exception cref="T:System.NotSupportedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
27 <member name="P:System.Net.WebResponse.ContentType">
28 <summary>When overridden in a derived class, gets or sets the content type of the data being received.</summary>
29 <returns>A string that contains the content type of the response.</returns>
30 <exception cref="T:System.NotSupportedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
32 <member name="M:System.Net.WebResponse.Dispose">
33 <summary>Releases the unmanaged resources used by the <see cref="T:System.Net.WebResponse"></see> object.</summary>
35 <member name="M:System.Net.WebResponse.Dispose(System.Boolean)">
36 <summary>Releases the unmanaged resources used by the <see cref="T:System.Net.WebResponse"></see> object, and optionally disposes of the managed resources.</summary>
37 <param name="disposing"><see langword="true"></see> to release both managed and unmanaged resources; <see langword="false"></see> to releases only unmanaged resources.</param>
39 <member name="M:System.Net.WebResponse.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
40 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> with the data that is needed to serialize the target object.</summary>
41 <param name="serializationInfo">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to populate with data.</param>
42 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that specifies the destination for this serialization.</param>
44 <member name="M:System.Net.WebResponse.GetResponseStream">
45 <summary>When overridden in a descendant class, returns the data stream from the Internet resource.</summary>
46 <returns>An instance of the <see cref="T:System.IO.Stream"></see> class for reading data from the Internet resource.</returns>
47 <exception cref="T:System.NotSupportedException">Any attempt is made to access the method, when the method is not overridden in a descendant class.</exception>
49 <member name="P:System.Net.WebResponse.Headers">
50 <summary>When overridden in a derived class, gets a collection of header name-value pairs associated with this request.</summary>
51 <returns>An instance of the <see cref="T:System.Net.WebHeaderCollection"></see> class that contains header values associated with this response.</returns>
52 <exception cref="T:System.NotSupportedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
54 <member name="P:System.Net.WebResponse.IsFromCache">
55 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether this response was obtained from the cache.</summary>
56 <returns><see langword="true"></see> if the response was taken from the cache; otherwise, <see langword="false"></see>.</returns>
58 <member name="P:System.Net.WebResponse.IsMutuallyAuthenticated">
59 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether mutual authentication occurred.</summary>
60 <returns><see langword="true"></see> if both client and server were authenticated; otherwise, <see langword="false"></see>.</returns>
62 <member name="P:System.Net.WebResponse.ResponseUri">
63 <summary>When overridden in a derived class, gets the URI of the Internet resource that actually responded to the request.</summary>
64 <returns>An instance of the <see cref="T:System.Uri"></see> class that contains the URI of the Internet resource that actually responded to the request.</returns>
65 <exception cref="T:System.NotSupportedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
67 <member name="P:System.Net.WebResponse.SupportsHeaders">
68 <summary>Gets a value that indicates if headers are supported.</summary>
69 <returns>Returns <see cref="T:System.Boolean"></see>.
70 <see langword="true"></see> if headers are supported; otherwise, <see langword="false"></see>.</returns>
72 <member name="M:System.Net.WebResponse.System#Runtime#Serialization#ISerializable#GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
73 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> instance with the data that is needed to serialize <see cref="T:System.Net.WebResponse"></see>.</summary>
74 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> that will hold the serialized data for the <see cref="T:System.Net.WebResponse"></see>.</param>
75 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that contains the destination of the serialized stream that is associated with the new <see cref="T:System.Net.WebResponse"></see>.</param>
77 <member name="T:System.Net.WebRequestMethods">
78 <summary>Container class for <see cref="T:System.Net.WebRequestMethods.Ftp"></see>, <see cref="T:System.Net.WebRequestMethods.File"></see>, and <see cref="T:System.Net.WebRequestMethods.Http"></see> classes. This class cannot be inherited</summary>
80 <member name="T:System.Net.WebRequestMethods.Http">
81 <summary>Represents the types of HTTP protocol methods that can be used with an HTTP request.</summary>
83 <member name="F:System.Net.WebRequestMethods.Http.Connect">
84 <summary>Represents the HTTP CONNECT protocol method that is used with a proxy that can dynamically switch to tunneling, as in the case of SSL tunneling.</summary>
87 <member name="F:System.Net.WebRequestMethods.Http.Get">
88 <summary>Represents an HTTP GET protocol method.</summary>
91 <member name="F:System.Net.WebRequestMethods.Http.Head">
92 <summary>Represents an HTTP HEAD protocol method. The HEAD method is identical to GET except that the server only returns message-headers in the response, without a message-body.</summary>
95 <member name="F:System.Net.WebRequestMethods.Http.MkCol">
96 <summary>Represents an HTTP MKCOL request that creates a new collection (such as a collection of pages) at the location specified by the request-Uniform Resource Identifier (URI).</summary>
99 <member name="F:System.Net.WebRequestMethods.Http.Post">
100 <summary>Represents an HTTP POST protocol method that is used to post a new entity as an addition to a URI.</summary>
103 <member name="F:System.Net.WebRequestMethods.Http.Put">
104 <summary>Represents an HTTP PUT protocol method that is used to replace an entity identified by a URI.</summary>
107 <member name="T:System.Net.WebRequestMethods.Ftp">
108 <summary>Represents the types of FTP protocol methods that can be used with an FTP request. This class cannot be inherited.</summary>
110 <member name="F:System.Net.WebRequestMethods.Ftp.AppendFile">
111 <summary>Represents the FTP APPE protocol method that is used to append a file to an existing file on an FTP server.</summary>
114 <member name="F:System.Net.WebRequestMethods.Ftp.DeleteFile">
115 <summary>Represents the FTP DELE protocol method that is used to delete a file on an FTP server.</summary>
118 <member name="F:System.Net.WebRequestMethods.Ftp.DownloadFile">
119 <summary>Represents the FTP RETR protocol method that is used to download a file from an FTP server.</summary>
122 <member name="F:System.Net.WebRequestMethods.Ftp.GetDateTimestamp">
123 <summary>Represents the FTP MDTM protocol method that is used to retrieve the date-time stamp from a file on an FTP server.</summary>
126 <member name="F:System.Net.WebRequestMethods.Ftp.GetFileSize">
127 <summary>Represents the FTP SIZE protocol method that is used to retrieve the size of a file on an FTP server.</summary>
130 <member name="F:System.Net.WebRequestMethods.Ftp.ListDirectory">
131 <summary>Represents the FTP NLIST protocol method that gets a short listing of the files on an FTP server.</summary>
134 <member name="F:System.Net.WebRequestMethods.Ftp.ListDirectoryDetails">
135 <summary>Represents the FTP LIST protocol method that gets a detailed listing of the files on an FTP server.</summary>
138 <member name="F:System.Net.WebRequestMethods.Ftp.MakeDirectory">
139 <summary>Represents the FTP MKD protocol method creates a directory on an FTP server.</summary>
142 <member name="F:System.Net.WebRequestMethods.Ftp.PrintWorkingDirectory">
143 <summary>Represents the FTP PWD protocol method that prints the name of the current working directory.</summary>
146 <member name="F:System.Net.WebRequestMethods.Ftp.RemoveDirectory">
147 <summary>Represents the FTP RMD protocol method that removes a directory.</summary>
150 <member name="F:System.Net.WebRequestMethods.Ftp.Rename">
151 <summary>Represents the FTP RENAME protocol method that renames a directory.</summary>
154 <member name="F:System.Net.WebRequestMethods.Ftp.UploadFile">
155 <summary>Represents the FTP STOR protocol method that uploads a file to an FTP server.</summary>
158 <member name="F:System.Net.WebRequestMethods.Ftp.UploadFileWithUniqueName">
159 <summary>Represents the FTP STOU protocol that uploads a file with a unique name to an FTP server.</summary>
162 <member name="T:System.Net.WebRequestMethods.File">
163 <summary>Represents the types of file protocol methods that can be used with a FILE request. This class cannot be inherited.</summary>
165 <member name="F:System.Net.WebRequestMethods.File.DownloadFile">
166 <summary>Represents the FILE GET protocol method that is used to retrieve a file from a specified location.</summary>
169 <member name="F:System.Net.WebRequestMethods.File.UploadFile">
170 <summary>Represents the FILE PUT protocol method that is used to copy a file to a specified location.</summary>
173 <member name="T:System.Net.WebRequest">
174 <summary>Makes a request to a Uniform Resource Identifier (URI). This is an <see langword="abstract"></see> class.</summary>
176 <member name="M:System.Net.WebRequest.#ctor">
177 <summary>Initializes a new instance of the <see cref="T:System.Net.WebRequest"></see> class.</summary>
179 <member name="M:System.Net.WebRequest.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
180 <summary>Initializes a new instance of the <see cref="T:System.Net.WebRequest"></see> class from the specified instances of the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> classes.</summary>
181 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> that contains the information required to serialize the new <see cref="T:System.Net.WebRequest"></see> instance.</param>
182 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that indicates the source of the serialized stream associated with the new <see cref="T:System.Net.WebRequest"></see> instance.</param>
183 <exception cref="T:System.NotImplementedException">Any attempt is made to access the constructor, when the constructor is not overridden in a descendant class.</exception>
185 <member name="M:System.Net.WebRequest.Abort">
186 <summary>Aborts the request.</summary>
187 <exception cref="T:System.NotImplementedException">Any attempt is made to access the method, when the method is not overridden in a descendant class.</exception>
189 <member name="P:System.Net.WebRequest.AuthenticationLevel">
190 <summary>Gets or sets values indicating the level of authentication and impersonation used for this request.</summary>
191 <returns>A bitwise combination of the <see cref="T:System.Net.Security.AuthenticationLevel"></see> values. The default value is <see cref="F:System.Net.Security.AuthenticationLevel.MutualAuthRequested"></see>.
192 In mutual authentication, both the client and server present credentials to establish their identity. The <see cref="F:System.Net.Security.AuthenticationLevel.MutualAuthRequired"></see> and <see cref="F:System.Net.Security.AuthenticationLevel.MutualAuthRequested"></see> values are relevant for Kerberos authentication. Kerberos authentication can be supported directly, or can be used if the Negotiate security protocol is used to select the actual security protocol. For more information about authentication protocols, see Internet Authentication.
193 To determine whether mutual authentication occurred, check the <see cref="P:System.Net.WebResponse.IsMutuallyAuthenticated"></see> property.
194 If you specify the <see cref="F:System.Net.Security.AuthenticationLevel.MutualAuthRequired"></see> authentication flag value and mutual authentication does not occur, your application will receive an <see cref="T:System.IO.IOException"></see> with a <see cref="T:System.Net.ProtocolViolationException"></see> inner exception indicating that mutual authentication failed.</returns>
196 <member name="M:System.Net.WebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)">
197 <summary>When overridden in a descendant class, provides an asynchronous version of the <see cref="M:System.Net.WebRequest.GetRequestStream"></see> method.</summary>
198 <param name="callback">The <see cref="T:System.AsyncCallback"></see> delegate.</param>
199 <param name="state">An object containing state information for this asynchronous request.</param>
200 <returns>An <see cref="T:System.IAsyncResult"></see> that references the asynchronous request.</returns>
201 <exception cref="T:System.NotImplementedException">Any attempt is made to access the method, when the method is not overridden in a descendant class.</exception>
203 <member name="M:System.Net.WebRequest.BeginGetResponse(System.AsyncCallback,System.Object)">
204 <summary>When overridden in a descendant class, begins an asynchronous request for an Internet resource.</summary>
205 <param name="callback">The <see cref="T:System.AsyncCallback"></see> delegate.</param>
206 <param name="state">An object containing state information for this asynchronous request.</param>
207 <returns>An <see cref="T:System.IAsyncResult"></see> that references the asynchronous request.</returns>
208 <exception cref="T:System.NotImplementedException">Any attempt is made to access the method, when the method is not overridden in a descendant class.</exception>
210 <member name="P:System.Net.WebRequest.CachePolicy">
211 <summary>Gets or sets the cache policy for this request.</summary>
212 <returns>A <see cref="T:System.Net.Cache.RequestCachePolicy"></see> object that defines a cache policy.</returns>
214 <member name="P:System.Net.WebRequest.ConnectionGroupName">
215 <summary>When overridden in a descendant class, gets or sets the name of the connection group for the request.</summary>
216 <returns>The name of the connection group for the request.</returns>
217 <exception cref="T:System.NotImplementedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
219 <member name="P:System.Net.WebRequest.ContentLength">
220 <summary>When overridden in a descendant class, gets or sets the content length of the request data being sent.</summary>
221 <returns>The number of bytes of request data being sent.</returns>
222 <exception cref="T:System.NotImplementedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
224 <member name="P:System.Net.WebRequest.ContentType">
225 <summary>When overridden in a descendant class, gets or sets the content type of the request data being sent.</summary>
226 <returns>The content type of the request data.</returns>
227 <exception cref="T:System.NotImplementedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
229 <member name="M:System.Net.WebRequest.Create(System.String)">
230 <summary>Initializes a new <see cref="T:System.Net.WebRequest"></see> instance for the specified URI scheme.</summary>
231 <param name="requestUriString">The URI that identifies the Internet resource.</param>
232 <returns>A <see cref="T:System.Net.WebRequest"></see> descendant for the specific URI scheme.</returns>
233 <exception cref="T:System.NotSupportedException">The request scheme specified in <paramref name="requestUriString">requestUriString</paramref> has not been registered.</exception>
234 <exception cref="T:System.ArgumentNullException"><paramref name="requestUriString">requestUriString</paramref> is <see langword="null"></see>.</exception>
235 <exception cref="T:System.Security.SecurityException">The caller does not have permission to connect to the requested URI or a URI that the request is redirected to.</exception>
236 <exception cref="T:System.UriFormatException">
238 In the [.NET for Windows Store apps](http://go.microsoft.com/fwlink/?LinkID=247912) or the [Portable Class Library](http://msdn.microsoft.com/library/c31e1663-c164-4e65-b66d-d3aa8750a154), catch the base class exception, <see cref="System.FormatException"></see>, instead.
243 The URI specified in <paramref name="requestUriString">requestUriString</paramref> is not a valid URI.</exception>
245 <member name="M:System.Net.WebRequest.Create(System.Uri)">
246 <summary>Initializes a new <see cref="T:System.Net.WebRequest"></see> instance for the specified URI scheme.</summary>
247 <param name="requestUri">A <see cref="T:System.Uri"></see> containing the URI of the requested resource.</param>
248 <returns>A <see cref="T:System.Net.WebRequest"></see> descendant for the specified URI scheme.</returns>
249 <exception cref="T:System.NotSupportedException">The request scheme specified in <paramref name="requestUri">requestUri</paramref> is not registered.</exception>
250 <exception cref="T:System.ArgumentNullException"><paramref name="requestUri">requestUri</paramref> is <see langword="null"></see>.</exception>
251 <exception cref="T:System.Security.SecurityException">The caller does not have permission to connect to the requested URI or a URI that the request is redirected to.</exception>
253 <member name="M:System.Net.WebRequest.CreateDefault(System.Uri)">
254 <summary>Initializes a new <see cref="T:System.Net.WebRequest"></see> instance for the specified URI scheme.</summary>
255 <param name="requestUri">A <see cref="T:System.Uri"></see> containing the URI of the requested resource.</param>
256 <returns>A <see cref="T:System.Net.WebRequest"></see> descendant for the specified URI scheme.</returns>
257 <exception cref="T:System.NotSupportedException">The request scheme specified in <paramref name="requestUri">requestUri</paramref> is not registered.</exception>
258 <exception cref="T:System.ArgumentNullException"><paramref name="requestUri">requestUri</paramref> is <see langword="null"></see>.</exception>
259 <exception cref="T:System.Security.SecurityException">The caller does not have permission to connect to the requested URI or a URI that the request is redirected to.</exception>
261 <member name="M:System.Net.WebRequest.CreateHttp(System.String)">
262 <summary>Initializes a new <see cref="T:System.Net.HttpWebRequest"></see> instance for the specified URI string.</summary>
263 <param name="requestUriString">A URI string that identifies the Internet resource.</param>
264 <returns>An <see cref="T:System.Net.HttpWebRequest"></see> instance for the specific URI string.</returns>
265 <exception cref="T:System.NotSupportedException">The request scheme specified in <paramref name="requestUriString">requestUriString</paramref> is the http or https scheme.</exception>
266 <exception cref="T:System.ArgumentNullException"><paramref name="requestUriString">requestUriString</paramref> is <see langword="null"></see>.</exception>
267 <exception cref="T:System.Security.SecurityException">The caller does not have permission to connect to the requested URI or a URI that the request is redirected to.</exception>
268 <exception cref="T:System.UriFormatException">The URI specified in <paramref name="requestUriString">requestUriString</paramref> is not a valid URI.</exception>
270 <member name="M:System.Net.WebRequest.CreateHttp(System.Uri)">
271 <summary>Initializes a new <see cref="T:System.Net.HttpWebRequest"></see> instance for the specified URI.</summary>
272 <param name="requestUri">A URI that identifies the Internet resource.</param>
273 <returns>An <see cref="T:System.Net.HttpWebRequest"></see> instance for the specific URI string.</returns>
274 <exception cref="T:System.NotSupportedException">The request scheme specified in <paramref name="requestUri">requestUri</paramref> is the http or https scheme.</exception>
275 <exception cref="T:System.ArgumentNullException"><paramref name="requestUri">requestUri</paramref> is <see langword="null"></see>.</exception>
276 <exception cref="T:System.Security.SecurityException">The caller does not have permission to connect to the requested URI or a URI that the request is redirected to.</exception>
277 <exception cref="T:System.UriFormatException">The URI specified in <paramref name="requestUri">requestUri</paramref> is not a valid URI.</exception>
279 <member name="P:System.Net.WebRequest.Credentials">
280 <summary>When overridden in a descendant class, gets or sets the network credentials used for authenticating the request with the Internet resource.</summary>
281 <returns>An <see cref="T:System.Net.ICredentials"></see> containing the authentication credentials associated with the request. The default is <see langword="null"></see>.</returns>
282 <exception cref="T:System.NotImplementedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
284 <member name="P:System.Net.WebRequest.DefaultCachePolicy">
285 <summary>Gets or sets the default cache policy for this request.</summary>
286 <returns>A <see cref="T:System.Net.Cache.HttpRequestCachePolicy"></see> that specifies the cache policy in effect for this request when no other policy is applicable.</returns>
288 <member name="P:System.Net.WebRequest.DefaultWebProxy">
289 <summary>Gets or sets the global HTTP proxy.</summary>
290 <returns>An <see cref="T:System.Net.IWebProxy"></see> used by every call to instances of <see cref="T:System.Net.WebRequest"></see>.</returns>
292 <member name="M:System.Net.WebRequest.EndGetRequestStream(System.IAsyncResult)">
293 <summary>When overridden in a descendant class, returns a <see cref="T:System.IO.Stream"></see> for writing data to the Internet resource.</summary>
294 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> that references a pending request for a stream.</param>
295 <returns>A <see cref="T:System.IO.Stream"></see> to write data to.</returns>
296 <exception cref="T:System.NotImplementedException">Any attempt is made to access the method, when the method is not overridden in a descendant class.</exception>
298 <member name="M:System.Net.WebRequest.EndGetResponse(System.IAsyncResult)">
299 <summary>When overridden in a descendant class, returns a <see cref="T:System.Net.WebResponse"></see>.</summary>
300 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> that references a pending request for a response.</param>
301 <returns>A <see cref="T:System.Net.WebResponse"></see> that contains a response to the Internet request.</returns>
302 <exception cref="T:System.NotImplementedException">Any attempt is made to access the method, when the method is not overridden in a descendant class.</exception>
304 <member name="M:System.Net.WebRequest.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
305 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> with the data needed to serialize the target object.</summary>
306 <param name="serializationInfo">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to populate with data.</param>
307 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that specifies the destination for this serialization.</param>
309 <member name="M:System.Net.WebRequest.GetRequestStream">
310 <summary>When overridden in a descendant class, returns a <see cref="T:System.IO.Stream"></see> for writing data to the Internet resource.</summary>
311 <returns>A <see cref="T:System.IO.Stream"></see> for writing data to the Internet resource.</returns>
312 <exception cref="T:System.NotImplementedException">Any attempt is made to access the method, when the method is not overridden in a descendant class.</exception>
314 <member name="M:System.Net.WebRequest.GetRequestStreamAsync">
315 <summary>When overridden in a descendant class, returns a <see cref="T:System.IO.Stream"></see> for writing data to the Internet resource as an asynchronous operation.</summary>
316 <returns>The task object representing the asynchronous operation.</returns>
318 <member name="M:System.Net.WebRequest.GetResponse">
319 <summary>When overridden in a descendant class, returns a response to an Internet request.</summary>
320 <returns>A <see cref="T:System.Net.WebResponse"></see> containing the response to the Internet request.</returns>
321 <exception cref="T:System.NotImplementedException">Any attempt is made to access the method, when the method is not overridden in a descendant class.</exception>
323 <member name="M:System.Net.WebRequest.GetResponseAsync">
324 <summary>When overridden in a descendant class, returns a response to an Internet request as an asynchronous operation.</summary>
325 <returns>The task object representing the asynchronous operation.</returns>
327 <member name="M:System.Net.WebRequest.GetSystemWebProxy">
328 <summary>Returns a proxy configured with the Internet Explorer settings of the currently impersonated user.</summary>
329 <returns>An <see cref="T:System.Net.IWebProxy"></see> used by every call to instances of <see cref="T:System.Net.WebRequest"></see>.</returns>
331 <member name="P:System.Net.WebRequest.Headers">
332 <summary>When overridden in a descendant class, gets or sets the collection of header name/value pairs associated with the request.</summary>
333 <returns>A <see cref="T:System.Net.WebHeaderCollection"></see> containing the header name/value pairs associated with this request.</returns>
334 <exception cref="T:System.NotImplementedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
336 <member name="P:System.Net.WebRequest.ImpersonationLevel">
337 <summary>Gets or sets the impersonation level for the current request.</summary>
338 <returns>A <see cref="T:System.Security.Principal.TokenImpersonationLevel"></see> value.</returns>
340 <member name="P:System.Net.WebRequest.Method">
341 <summary>When overridden in a descendant class, gets or sets the protocol method to use in this request.</summary>
342 <returns>The protocol method to use in this request.</returns>
343 <exception cref="T:System.NotImplementedException">If the property is not overridden in a descendant class, any attempt is made to get or set the property.</exception>
345 <member name="P:System.Net.WebRequest.PreAuthenticate">
346 <summary>When overridden in a descendant class, indicates whether to pre-authenticate the request.</summary>
347 <returns><see langword="true"></see> to pre-authenticate; otherwise, <see langword="false"></see>.</returns>
348 <exception cref="T:System.NotImplementedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
350 <member name="P:System.Net.WebRequest.Proxy">
351 <summary>When overridden in a descendant class, gets or sets the network proxy to use to access this Internet resource.</summary>
352 <returns>The <see cref="T:System.Net.IWebProxy"></see> to use to access the Internet resource.</returns>
353 <exception cref="T:System.NotImplementedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
355 <member name="M:System.Net.WebRequest.RegisterPrefix(System.String,System.Net.IWebRequestCreate)">
356 <summary>Registers a <see cref="T:System.Net.WebRequest"></see> descendant for the specified URI.</summary>
357 <param name="prefix">The complete URI or URI prefix that the <see cref="T:System.Net.WebRequest"></see> descendant services.</param>
358 <param name="creator">The create method that the <see cref="T:System.Net.WebRequest"></see> calls to create the <see cref="T:System.Net.WebRequest"></see> descendant.</param>
359 <returns><see langword="true"></see> if registration is successful; otherwise, <see langword="false"></see>.</returns>
360 <exception cref="T:System.ArgumentNullException"><paramref name="prefix">prefix</paramref> is <see langword="null"></see>
362 <paramref name="creator">creator</paramref> is <see langword="null"></see>.</exception>
364 <member name="P:System.Net.WebRequest.RequestUri">
365 <summary>When overridden in a descendant class, gets the URI of the Internet resource associated with the request.</summary>
366 <returns>A <see cref="T:System.Uri"></see> representing the resource associated with the request</returns>
367 <exception cref="T:System.NotImplementedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
369 <member name="P:System.Net.WebRequest.Timeout">
370 <summary>Gets or sets the length of time, in milliseconds, before the request times out.</summary>
371 <returns>The length of time, in milliseconds, until the request times out, or the value <see cref="F:System.Threading.Timeout.Infinite"></see> to indicate that the request does not time out. The default value is defined by the descendant class.</returns>
372 <exception cref="T:System.NotImplementedException">Any attempt is made to get or set the property, when the property is not overridden in a descendant class.</exception>
374 <member name="P:System.Net.WebRequest.UseDefaultCredentials">
375 <summary>When overridden in a descendant class, gets or sets a <see cref="T:System.Boolean"></see> value that controls whether <see cref="P:System.Net.CredentialCache.DefaultCredentials"></see> are sent with requests.</summary>
376 <returns><see langword="true"></see> if the default credentials are used; otherwise <see langword="false"></see>. The default value is <see langword="false"></see>.</returns>
377 <exception cref="T:System.InvalidOperationException">You attempted to set this property after the request was sent.</exception>
378 <exception cref="T:System.NotImplementedException">Any attempt is made to access the property, when the property is not overridden in a descendant class.</exception>
380 <member name="M:System.Net.WebRequest.System#Runtime#Serialization#ISerializable#GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
381 <summary>When overridden in a descendant class, populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> instance with the data needed to serialize the <see cref="T:System.Net.WebRequest"></see>.</summary>
382 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see>, which holds the serialized data for the <see cref="T:System.Net.WebRequest"></see>.</param>
383 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that contains the destination of the serialized stream associated with the new <see cref="T:System.Net.WebRequest"></see>.</param>
384 <exception cref="T:System.NotImplementedException">An attempt is made to serialize the object, when the interface is not overridden in a descendant class.</exception>
386 <member name="T:System.Net.WebExceptionStatus">
387 <summary>Defines status codes for the <see cref="T:System.Net.WebException"></see> class.</summary>
389 <member name="F:System.Net.WebExceptionStatus.CacheEntryNotFound">
390 <summary>The specified cache entry was not found.</summary>
393 <member name="F:System.Net.WebExceptionStatus.ConnectFailure">
394 <summary>The remote service point could not be contacted at the transport level.</summary>
397 <member name="F:System.Net.WebExceptionStatus.ConnectionClosed">
398 <summary>The connection was prematurely closed.</summary>
401 <member name="F:System.Net.WebExceptionStatus.KeepAliveFailure">
402 <summary>The connection for a request that specifies the Keep-alive header was closed unexpectedly.</summary>
405 <member name="F:System.Net.WebExceptionStatus.MessageLengthLimitExceeded">
406 <summary>A message was received that exceeded the specified limit when sending a request or receiving a response from the server.</summary>
409 <member name="F:System.Net.WebExceptionStatus.NameResolutionFailure">
410 <summary>The name resolver service could not resolve the host name.</summary>
413 <member name="F:System.Net.WebExceptionStatus.Pending">
414 <summary>An internal asynchronous request is pending.</summary>
417 <member name="F:System.Net.WebExceptionStatus.PipelineFailure">
418 <summary>The request was a pipelined request and the connection was closed before the response was received.</summary>
421 <member name="F:System.Net.WebExceptionStatus.ProtocolError">
422 <summary>The response received from the server was complete but indicated a protocol-level error. For example, an HTTP protocol error such as 401 Access Denied would use this status.</summary>
425 <member name="F:System.Net.WebExceptionStatus.ProxyNameResolutionFailure">
426 <summary>The name resolver service could not resolve the proxy host name.</summary>
429 <member name="F:System.Net.WebExceptionStatus.ReceiveFailure">
430 <summary>A complete response was not received from the remote server.</summary>
433 <member name="F:System.Net.WebExceptionStatus.RequestCanceled">
434 <summary>The request was canceled, the <see cref="M:System.Net.WebRequest.Abort"></see> method was called, or an unclassifiable error occurred. This is the default value for <see cref="P:System.Net.WebException.Status"></see>.</summary>
437 <member name="F:System.Net.WebExceptionStatus.RequestProhibitedByCachePolicy">
438 <summary>The request was not permitted by the cache policy. In general, this occurs when a request is not cacheable and the effective policy prohibits sending the request to the server. You might receive this status if a request method implies the presence of a request body, a request method requires direct interaction with the server, or a request contains a conditional header.</summary>
441 <member name="F:System.Net.WebExceptionStatus.RequestProhibitedByProxy">
442 <summary>This request was not permitted by the proxy.</summary>
445 <member name="F:System.Net.WebExceptionStatus.SecureChannelFailure">
446 <summary>An error occurred while establishing a connection using SSL.</summary>
449 <member name="F:System.Net.WebExceptionStatus.SendFailure">
450 <summary>A complete request could not be sent to the remote server.</summary>
453 <member name="F:System.Net.WebExceptionStatus.ServerProtocolViolation">
454 <summary>The server response was not a valid HTTP response.</summary>
457 <member name="F:System.Net.WebExceptionStatus.Success">
458 <summary>No error was encountered.</summary>
461 <member name="F:System.Net.WebExceptionStatus.Timeout">
462 <summary>No response was received during the time-out period for a request.</summary>
465 <member name="F:System.Net.WebExceptionStatus.TrustFailure">
466 <summary>A server certificate could not be validated.</summary>
469 <member name="F:System.Net.WebExceptionStatus.UnknownError">
470 <summary>An exception of unknown type has occurred.</summary>
473 <member name="T:System.Net.WebException">
474 <summary>The exception that is thrown when an error occurs while accessing the network through a pluggable protocol.</summary>
476 <member name="M:System.Net.WebException.#ctor">
477 <summary>Initializes a new instance of the <see cref="T:System.Net.WebException"></see> class.</summary>
479 <member name="M:System.Net.WebException.#ctor(System.String)">
480 <summary>Initializes a new instance of the <see cref="T:System.Net.WebException"></see> class with the specified error message.</summary>
481 <param name="message">The text of the error message.</param>
483 <member name="M:System.Net.WebException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
484 <summary>Initializes a new instance of the <see cref="T:System.Net.WebException"></see> class from the specified <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> instances.</summary>
485 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> that contains the information required to serialize the new <see cref="T:System.Net.WebException"></see>.</param>
486 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that contains the source of the serialized stream that is associated with the new <see cref="T:System.Net.WebException"></see>.</param>
488 <member name="M:System.Net.WebException.#ctor(System.String,System.Exception)">
489 <summary>Initializes a new instance of the <see cref="T:System.Net.WebException"></see> class with the specified error message and nested exception.</summary>
490 <param name="message">The text of the error message.</param>
491 <param name="innerException">A nested exception.</param>
493 <member name="M:System.Net.WebException.#ctor(System.String,System.Net.WebExceptionStatus)">
494 <summary>Initializes a new instance of the <see cref="T:System.Net.WebException"></see> class with the specified error message and status.</summary>
495 <param name="message">The text of the error message.</param>
496 <param name="status">One of the <see cref="T:System.Net.WebExceptionStatus"></see> values.</param>
498 <member name="M:System.Net.WebException.#ctor(System.String,System.Exception,System.Net.WebExceptionStatus,System.Net.WebResponse)">
499 <summary>Initializes a new instance of the <see cref="T:System.Net.WebException"></see> class with the specified error message, nested exception, status, and response.</summary>
500 <param name="message">The text of the error message.</param>
501 <param name="innerException">A nested exception.</param>
502 <param name="status">One of the <see cref="T:System.Net.WebExceptionStatus"></see> values.</param>
503 <param name="response">A <see cref="T:System.Net.WebResponse"></see> instance that contains the response from the remote host.</param>
505 <member name="M:System.Net.WebException.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
506 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> instance with the data needed to serialize the <see cref="T:System.Net.WebException"></see>.</summary>
507 <param name="serializationInfo">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to be used.</param>
508 <param name="streamingContext">The <see cref="T:System.Runtime.Serialization.StreamingContext"></see> to be used.</param>
510 <member name="P:System.Net.WebException.Response">
511 <summary>Gets the response that the remote host returned.</summary>
512 <returns>If a response is available from the Internet resource, a <see cref="T:System.Net.WebResponse"></see> instance that contains the error response from an Internet resource; otherwise, <see langword="null"></see>.</returns>
514 <member name="P:System.Net.WebException.Status">
515 <summary>Gets the status of the response.</summary>
516 <returns>One of the <see cref="T:System.Net.WebExceptionStatus"></see> values.</returns>
518 <member name="M:System.Net.WebException.System#Runtime#Serialization#ISerializable#GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
519 <summary>Serializes this instance into the specified <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object.</summary>
520 <param name="serializationInfo">The object into which this <see cref="T:System.Net.WebException"></see> will be serialized.</param>
521 <param name="streamingContext">The destination of the serialization.</param>
523 <member name="T:System.Net.ProtocolViolationException">
524 <summary>The exception that is thrown when an error is made while using a network protocol.</summary>
526 <member name="M:System.Net.ProtocolViolationException.#ctor">
527 <summary>Initializes a new instance of the <see cref="T:System.Net.ProtocolViolationException"></see> class.</summary>
529 <member name="M:System.Net.ProtocolViolationException.#ctor(System.String)">
530 <summary>Initializes a new instance of the <see cref="T:System.Net.ProtocolViolationException"></see> class with the specified message.</summary>
531 <param name="message">The error message string.</param>
533 <member name="M:System.Net.ProtocolViolationException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
534 <summary>Initializes a new instance of the <see cref="T:System.Net.ProtocolViolationException"></see> class from the specified <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> instances.</summary>
535 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> that contains the information that is required to deserialize the <see cref="T:System.Net.ProtocolViolationException"></see>.</param>
536 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that contains the source of the serialized stream that is associated with the new <see cref="T:System.Net.ProtocolViolationException"></see>.</param>
538 <member name="M:System.Net.ProtocolViolationException.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
539 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> with the data required to serialize the target object.</summary>
540 <param name="serializationInfo">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to populate with data.</param>
541 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that specifies the destination for this serialization.</param>
543 <member name="M:System.Net.ProtocolViolationException.System#Runtime#Serialization#ISerializable#GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
544 <summary>Serializes this instance into the specified <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object.</summary>
545 <param name="serializationInfo">The object into which this <see cref="T:System.Net.ProtocolViolationException"></see> will be serialized.</param>
546 <param name="streamingContext">The destination of the serialization.</param>
548 <member name="T:System.Net.IWebRequestCreate">
549 <summary>Provides the base interface for creating <see cref="T:System.Net.WebRequest"></see> instances.</summary>
551 <member name="M:System.Net.IWebRequestCreate.Create(System.Uri)">
552 <summary>Creates a <see cref="T:System.Net.WebRequest"></see> instance.</summary>
553 <param name="uri">The uniform resource identifier (URI) of the Web resource.</param>
554 <returns>A <see cref="T:System.Net.WebRequest"></see> instance.</returns>
555 <exception cref="T:System.NotSupportedException">The request scheme specified in <paramref name="uri">uri</paramref> is not supported by this <see cref="System.Net.IWebRequestCreate"></see> instance.</exception>
556 <exception cref="T:System.ArgumentNullException"><paramref name="uri">uri</paramref> is <see langword="null"></see>.</exception>
557 <exception cref="T:System.UriFormatException">
559 In the [.NET for Windows Store apps](http://go.microsoft.com/fwlink/?LinkID=247912) or the [Portable Class Library](~/docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md), catch the base class exception, <see cref="System.FormatException"></see>, instead.
564 The URI specified in <paramref name="uri">uri</paramref> is not a valid URI.</exception>
566 <member name="T:System.Net.ICredentialPolicy">
567 <summary>Defines the credential policy to be used for resource requests that are made using <see cref="T:System.Net.WebRequest"></see> and its derived classes.</summary>
569 <member name="M:System.Net.ICredentialPolicy.ShouldSendCredential(System.Uri,System.Net.WebRequest,System.Net.NetworkCredential,System.Net.IAuthenticationModule)">
570 <summary>Returns a <see cref="T:System.Boolean"></see> that indicates whether the client&#39;s credentials are sent with a resource request made using an instance of the <see cref="T:System.Net.WebRequest"></see> class.</summary>
571 <param name="challengeUri">The <see cref="T:System.Uri"></see> that will receive the request.</param>
572 <param name="request">The <see cref="T:System.Net.WebRequest"></see> that represents the resource being requested.</param>
573 <param name="credential">The <see cref="T:System.Net.NetworkCredential"></see> that will be sent with the request if this method returns <see langword="true"></see>.</param>
574 <param name="authenticationModule">The <see cref="T:System.Net.IAuthenticationModule"></see> that will conduct the authentication, if authentication is required.</param>
575 <returns><see langword="true"></see> if the credentials are sent with the request; otherwise, <see langword="false"></see>.</returns>
577 <member name="T:System.Net.IAuthenticationModule">
578 <summary>Provides the base authentication interface for Web client authentication modules.</summary>
580 <member name="M:System.Net.IAuthenticationModule.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)">
581 <summary>Returns an instance of the <see cref="T:System.Net.Authorization"></see> class in respose to an authentication challenge from a server.</summary>
582 <param name="challenge">The authentication challenge sent by the server.</param>
583 <param name="request">The <see cref="T:System.Net.WebRequest"></see> instance associated with the challenge.</param>
584 <param name="credentials">The credentials associated with the challenge.</param>
585 <returns>An <see cref="T:System.Net.Authorization"></see> instance containing the authorization message for the request, or <see langword="null"></see> if the challenge cannot be handled.</returns>
587 <member name="P:System.Net.IAuthenticationModule.AuthenticationType">
588 <summary>Gets the authentication type provided by this authentication module.</summary>
589 <returns>A string indicating the authentication type provided by this authentication module.</returns>
591 <member name="P:System.Net.IAuthenticationModule.CanPreAuthenticate">
592 <summary>Gets a value indicating whether the authentication module supports preauthentication.</summary>
593 <returns><see langword="true"></see> if the authorization module supports preauthentication; otherwise <see langword="false"></see>.</returns>
595 <member name="M:System.Net.IAuthenticationModule.PreAuthenticate(System.Net.WebRequest,System.Net.ICredentials)">
596 <summary>Returns an instance of the <see cref="T:System.Net.Authorization"></see> class for an authentication request to a server.</summary>
597 <param name="request">The <see cref="T:System.Net.WebRequest"></see> instance associated with the authentication request.</param>
598 <param name="credentials">The credentials associated with the authentication request.</param>
599 <returns>An <see cref="T:System.Net.Authorization"></see> instance containing the authorization message for the request.</returns>
601 <member name="T:System.Net.HttpWebResponse">
602 <summary>Provides an HTTP-specific implementation of the <see cref="T:System.Net.WebResponse"></see> class.</summary>
604 <member name="M:System.Net.HttpWebResponse.#ctor">
605 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpWebResponse"></see> class.</summary>
607 <member name="M:System.Net.HttpWebResponse.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
608 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpWebResponse"></see> class from the specified <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> instances.</summary>
609 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> that contains the information required to serialize the new <see cref="T:System.Net.HttpWebRequest"></see>.</param>
610 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that contains the source of the serialized stream that is associated with the new <see cref="T:System.Net.HttpWebRequest"></see>.</param>
612 <member name="P:System.Net.HttpWebResponse.CharacterSet">
613 <summary>Gets the character set of the response.</summary>
614 <returns>A string that contains the character set of the response.</returns>
615 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
617 <member name="M:System.Net.HttpWebResponse.Close">
618 <summary>Closes the response stream.</summary>
620 <member name="P:System.Net.HttpWebResponse.ContentEncoding">
621 <summary>Gets the method that is used to encode the body of the response.</summary>
622 <returns>A string that describes the method that is used to encode the body of the response.</returns>
623 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
625 <member name="P:System.Net.HttpWebResponse.ContentLength">
626 <summary>Gets the length of the content returned by the request.</summary>
627 <returns>The number of bytes returned by the request. Content length does not include header information.</returns>
628 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
630 <member name="P:System.Net.HttpWebResponse.ContentType">
631 <summary>Gets the content type of the response.</summary>
632 <returns>A string that contains the content type of the response.</returns>
633 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
635 <member name="P:System.Net.HttpWebResponse.Cookies">
636 <summary>Gets or sets the cookies that are associated with this response.</summary>
637 <returns>A <see cref="T:System.Net.CookieCollection"></see> that contains the cookies that are associated with this response.</returns>
638 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
640 <member name="M:System.Net.HttpWebResponse.Dispose(System.Boolean)">
641 <summary>Releases the unmanaged resources used by the <see cref="T:System.Net.HttpWebResponse"></see>, and optionally disposes of the managed resources.</summary>
642 <param name="disposing"><see langword="true"></see> to release both managed and unmanaged resources; <see langword="false"></see> to releases only unmanaged resources.</param>
644 <member name="M:System.Net.HttpWebResponse.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
645 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> with the data needed to serialize the target object.</summary>
646 <param name="serializationInfo">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to populate with data.</param>
647 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that specifies the destination for this serialization.</param>
649 <member name="M:System.Net.HttpWebResponse.GetResponseHeader(System.String)">
650 <summary>Gets the contents of a header that was returned with the response.</summary>
651 <param name="headerName">The header value to return.</param>
652 <returns>The contents of the specified header.</returns>
653 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
655 <member name="M:System.Net.HttpWebResponse.GetResponseStream">
656 <summary>Gets the stream that is used to read the body of the response from the server.</summary>
657 <returns>A <see cref="T:System.IO.Stream"></see> containing the body of the response.</returns>
658 <exception cref="T:System.Net.ProtocolViolationException">There is no response stream.</exception>
659 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
661 <member name="P:System.Net.HttpWebResponse.Headers">
662 <summary>Gets the headers that are associated with this response from the server.</summary>
663 <returns>A <see cref="T:System.Net.WebHeaderCollection"></see> that contains the header information returned with the response.</returns>
664 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
666 <member name="P:System.Net.HttpWebResponse.IsMutuallyAuthenticated">
667 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether both client and server were authenticated.</summary>
668 <returns><see langword="true"></see> if mutual authentication occurred; otherwise, <see langword="false"></see>.</returns>
669 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
671 <member name="P:System.Net.HttpWebResponse.LastModified">
672 <summary>Gets the last date and time that the contents of the response were modified.</summary>
673 <returns>A <see cref="T:System.DateTime"></see> that contains the date and time that the contents of the response were modified.</returns>
674 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
676 <member name="P:System.Net.HttpWebResponse.Method">
677 <summary>Gets the method that is used to return the response.</summary>
678 <returns>A string that contains the HTTP method that is used to return the response.</returns>
679 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
681 <member name="P:System.Net.HttpWebResponse.ProtocolVersion">
682 <summary>Gets the version of the HTTP protocol that is used in the response.</summary>
683 <returns>A <see cref="T:System.Version"></see> that contains the HTTP protocol version of the response.</returns>
684 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
686 <member name="P:System.Net.HttpWebResponse.ResponseUri">
687 <summary>Gets the URI of the Internet resource that responded to the request.</summary>
688 <returns>The URI of the Internet resource that responded to the request.</returns>
689 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
691 <member name="P:System.Net.HttpWebResponse.Server">
692 <summary>Gets the name of the server that sent the response.</summary>
693 <returns>A string that contains the name of the server that sent the response.</returns>
694 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
696 <member name="P:System.Net.HttpWebResponse.StatusCode">
697 <summary>Gets the status of the response.</summary>
698 <returns>One of the <see cref="T:System.Net.HttpStatusCode"></see> values.</returns>
699 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
701 <member name="P:System.Net.HttpWebResponse.StatusDescription">
702 <summary>Gets the status description returned with the response.</summary>
703 <returns>A string that describes the status of the response.</returns>
704 <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
706 <member name="P:System.Net.HttpWebResponse.SupportsHeaders">
707 <summary>Gets a value that indicates whether headers are supported.</summary>
708 <returns><see langword="true"></see> if headers are supported; otherwise, <see langword="false"></see>. Always returns <see langword="true"></see>.</returns>
710 <member name="M:System.Net.HttpWebResponse.System#Runtime#Serialization#ISerializable#GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
711 <summary>Serializes this instance into the specified <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object.</summary>
712 <param name="serializationInfo">The object into which this <see cref="T:System.Net.HttpWebResponse"></see> will be serialized.</param>
713 <param name="streamingContext">The destination of the serialization.</param>
715 <member name="T:System.Net.HttpWebRequest">
716 <summary>Provides an HTTP-specific implementation of the <see cref="T:System.Net.WebRequest"></see> class.</summary>
718 <member name="M:System.Net.HttpWebRequest.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
719 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpWebRequest"></see> class from the specified instances of the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> classes.</summary>
720 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object that contains the information required to serialize the new <see cref="T:System.Net.HttpWebRequest"></see> object.</param>
721 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> object that contains the source and destination of the serialized stream associated with the new <see cref="T:System.Net.HttpWebRequest"></see> object.</param>
723 <member name="M:System.Net.HttpWebRequest.Abort">
724 <summary>Cancels a request to an Internet resource.</summary>
726 <member name="P:System.Net.HttpWebRequest.Accept">
727 <summary>Gets or sets the value of the <see langword="Accept"></see> HTTP header.</summary>
728 <returns>The value of the <see langword="Accept"></see> HTTP header. The default value is <see langword="null"></see>.</returns>
730 <member name="M:System.Net.HttpWebRequest.AddRange(System.Int32)">
731 <summary>Adds a byte range header to a request for a specific range from the beginning or end of the requested data.</summary>
732 <param name="range">The starting or ending point of the range.</param>
733 <exception cref="T:System.ArgumentException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is invalid.</exception>
734 <exception cref="T:System.InvalidOperationException">The range header could not be added.</exception>
736 <member name="M:System.Net.HttpWebRequest.AddRange(System.Int64)">
737 <summary>Adds a byte range header to a request for a specific range from the beginning or end of the requested data.</summary>
738 <param name="range">The starting or ending point of the range.</param>
739 <exception cref="T:System.ArgumentException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is invalid.</exception>
740 <exception cref="T:System.InvalidOperationException">The range header could not be added.</exception>
742 <member name="M:System.Net.HttpWebRequest.AddRange(System.Int32,System.Int32)">
743 <summary>Adds a byte range header to the request for a specified range.</summary>
744 <param name="from">The position at which to start sending data.</param>
745 <param name="to">The position at which to stop sending data.</param>
746 <exception cref="T:System.ArgumentException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is invalid.</exception>
747 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="from">from</paramref> is greater than <paramref name="to">to</paramref>
749 <paramref name="from">from</paramref> or <paramref name="to">to</paramref> is less than 0.</exception>
750 <exception cref="T:System.InvalidOperationException">The range header could not be added.</exception>
752 <member name="M:System.Net.HttpWebRequest.AddRange(System.Int64,System.Int64)">
753 <summary>Adds a byte range header to the request for a specified range.</summary>
754 <param name="from">The position at which to start sending data.</param>
755 <param name="to">The position at which to stop sending data.</param>
756 <exception cref="T:System.ArgumentException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is invalid.</exception>
757 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="from">from</paramref> is greater than <paramref name="to">to</paramref>
759 <paramref name="from">from</paramref> or <paramref name="to">to</paramref> is less than 0.</exception>
760 <exception cref="T:System.InvalidOperationException">The range header could not be added.</exception>
762 <member name="M:System.Net.HttpWebRequest.AddRange(System.String,System.Int32)">
763 <summary>Adds a Range header to a request for a specific range from the beginning or end of the requested data.</summary>
764 <param name="rangeSpecifier">The description of the range.</param>
765 <param name="range">The starting or ending point of the range.</param>
766 <exception cref="T:System.ArgumentNullException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is <see langword="null"></see>.</exception>
767 <exception cref="T:System.ArgumentException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is invalid.</exception>
768 <exception cref="T:System.InvalidOperationException">The range header could not be added.</exception>
770 <member name="M:System.Net.HttpWebRequest.AddRange(System.String,System.Int64)">
771 <summary>Adds a Range header to a request for a specific range from the beginning or end of the requested data.</summary>
772 <param name="rangeSpecifier">The description of the range.</param>
773 <param name="range">The starting or ending point of the range.</param>
774 <exception cref="T:System.ArgumentNullException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is <see langword="null"></see>.</exception>
775 <exception cref="T:System.ArgumentException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is invalid.</exception>
776 <exception cref="T:System.InvalidOperationException">The range header could not be added.</exception>
778 <member name="M:System.Net.HttpWebRequest.AddRange(System.String,System.Int32,System.Int32)">
779 <summary>Adds a range header to a request for a specified range.</summary>
780 <param name="rangeSpecifier">The description of the range.</param>
781 <param name="from">The position at which to start sending data.</param>
782 <param name="to">The position at which to stop sending data.</param>
783 <exception cref="T:System.ArgumentNullException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is <see langword="null"></see>.</exception>
784 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="from">from</paramref> is greater than <paramref name="to">to</paramref>
786 <paramref name="from">from</paramref> or <paramref name="to">to</paramref> is less than 0.</exception>
787 <exception cref="T:System.ArgumentException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is invalid.</exception>
788 <exception cref="T:System.InvalidOperationException">The range header could not be added.</exception>
790 <member name="M:System.Net.HttpWebRequest.AddRange(System.String,System.Int64,System.Int64)">
791 <summary>Adds a range header to a request for a specified range.</summary>
792 <param name="rangeSpecifier">The description of the range.</param>
793 <param name="from">The position at which to start sending data.</param>
794 <param name="to">The position at which to stop sending data.</param>
795 <exception cref="T:System.ArgumentNullException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is <see langword="null"></see>.</exception>
796 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="from">from</paramref> is greater than <paramref name="to">to</paramref>
798 <paramref name="from">from</paramref> or <paramref name="to">to</paramref> is less than 0.</exception>
799 <exception cref="T:System.ArgumentException"><paramref name="rangeSpecifier">rangeSpecifier</paramref> is invalid.</exception>
800 <exception cref="T:System.InvalidOperationException">The range header could not be added.</exception>
802 <member name="P:System.Net.HttpWebRequest.Address">
803 <summary>Gets the Uniform Resource Identifier (URI) of the Internet resource that actually responds to the request.</summary>
804 <returns>A <see cref="T:System.Uri"></see> that identifies the Internet resource that actually responds to the request. The default is the URI used by the <see cref="M:System.Net.WebRequest.Create(System.String)"></see> method to initialize the request.</returns>
806 <member name="P:System.Net.HttpWebRequest.AllowAutoRedirect">
807 <summary>Gets or sets a value that indicates whether the request should follow redirection responses.</summary>
808 <returns><see langword="true"></see> if the request should automatically follow redirection responses from the Internet resource; otherwise, <see langword="false"></see>. The default value is <see langword="true"></see>.</returns>
810 <member name="P:System.Net.HttpWebRequest.AllowReadStreamBuffering">
811 <summary>Gets or sets a value that indicates whether to buffer the received from the Internet resource.</summary>
812 <returns><see langword="true"></see> to enable buffering of the data received from the Internet resource; <see langword="false"></see> to disable buffering. The default is <see langword="false"></see>.</returns>
814 <member name="P:System.Net.HttpWebRequest.AllowWriteStreamBuffering">
815 <summary>Gets or sets a value that indicates whether to buffer the data sent to the Internet resource.</summary>
816 <returns><see langword="true"></see> to enable buffering of the data sent to the Internet resource; <see langword="false"></see> to disable buffering. The default is <see langword="true"></see>.</returns>
818 <member name="P:System.Net.HttpWebRequest.AutomaticDecompression">
819 <summary>Gets or sets the type of decompression that is used.</summary>
820 <returns>A <see cref="T:System.Net.DecompressionMethods"></see> object that indicates the type of decompression that is used.</returns>
821 <exception cref="T:System.InvalidOperationException">The object&#39;s current state does not allow this property to be set.</exception>
823 <member name="M:System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)">
824 <summary>Begins an asynchronous request for a <see cref="T:System.IO.Stream"></see> object to use to write data.</summary>
825 <param name="callback">The <see cref="T:System.AsyncCallback"></see> delegate.</param>
826 <param name="state">The state object for this request.</param>
827 <returns>An <see cref="T:System.IAsyncResult"></see> that references the asynchronous request.</returns>
828 <exception cref="T:System.Net.ProtocolViolationException">The <see cref="System.Net.HttpWebRequest.Method"></see> property is GET or HEAD.
830 <see cref="System.Net.HttpWebRequest.KeepAlive"></see> is <see langword="true"></see>, <see cref="System.Net.HttpWebRequest.AllowWriteStreamBuffering"></see> is <see langword="false"></see>, <see cref="System.Net.HttpWebRequest.ContentLength"></see> is -1, <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="false"></see>, and <see cref="System.Net.HttpWebRequest.Method"></see> is POST or PUT.</exception>
831 <exception cref="T:System.InvalidOperationException">The stream is being used by a previous call to <see cref="System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see>
833 <see cref="System.Net.HttpWebRequest.TransferEncoding"></see> is set to a value and <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="false"></see>.
835 The thread pool is running out of threads.</exception>
836 <exception cref="T:System.NotSupportedException">The request cache validator indicated that the response for this request can be served from the cache; however, requests that write data must not use the cache. This exception can occur if you are using a custom cache validator that is incorrectly implemented.</exception>
837 <exception cref="T:System.Net.WebException"><see cref="System.Net.HttpWebRequest.Abort"></see> was previously called.</exception>
838 <exception cref="T:System.ObjectDisposedException">In a .NET Compact Framework application, a request stream with zero content length was not obtained and closed correctly. For more information about handling zero content length requests, see Network Programming in the .NET Compact Framework.</exception>
840 <member name="M:System.Net.HttpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)">
841 <summary>Begins an asynchronous request to an Internet resource.</summary>
842 <param name="callback">The <see cref="T:System.AsyncCallback"></see> delegate</param>
843 <param name="state">The state object for this request.</param>
844 <returns>An <see cref="T:System.IAsyncResult"></see> that references the asynchronous request for a response.</returns>
845 <exception cref="T:System.InvalidOperationException">The stream is already in use by a previous call to <see cref="System.Net.HttpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see>
847 <see cref="System.Net.HttpWebRequest.TransferEncoding"></see> is set to a value and <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="false"></see>.
849 The thread pool is running out of threads.</exception>
850 <exception cref="T:System.Net.ProtocolViolationException"><see cref="System.Net.HttpWebRequest.Method"></see> is GET or HEAD, and either <see cref="System.Net.HttpWebRequest.ContentLength"></see> is greater than zero or <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="true"></see>.
852 <see cref="System.Net.HttpWebRequest.KeepAlive"></see> is <see langword="true"></see>, <see cref="System.Net.HttpWebRequest.AllowWriteStreamBuffering"></see> is <see langword="false"></see>, and either <see cref="System.Net.HttpWebRequest.ContentLength"></see> is -1, <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="false"></see> and <see cref="System.Net.HttpWebRequest.Method"></see> is POST or PUT.
854 The <see cref="System.Net.HttpWebRequest"></see> has an entity body but the <see cref="System.Net.HttpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see> method is called without calling the <see cref="System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see> method.
856 The <see cref="System.Net.HttpWebRequest.ContentLength"></see> is greater than zero, but the application does not write all of the promised data.</exception>
857 <exception cref="T:System.Net.WebException"><see cref="System.Net.HttpWebRequest.Abort"></see> was previously called.</exception>
859 <member name="P:System.Net.HttpWebRequest.ClientCertificates">
860 <summary>Gets or sets the collection of security certificates that are associated with this request.</summary>
861 <returns>The <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection"></see> that contains the security certificates associated with this request.</returns>
862 <exception cref="T:System.ArgumentNullException">The value specified for a set operation is <see langword="null"></see>.</exception>
864 <member name="P:System.Net.HttpWebRequest.Connection">
865 <summary>Gets or sets the value of the <see langword="Connection"></see> HTTP header.</summary>
866 <returns>The value of the <see langword="Connection"></see> HTTP header. The default value is <see langword="null"></see>.</returns>
867 <exception cref="T:System.ArgumentException">The value of <see cref="System.Net.HttpWebRequest.Connection"></see> is set to Keep-alive or Close.</exception>
869 <member name="P:System.Net.HttpWebRequest.ConnectionGroupName">
870 <summary>Gets or sets the name of the connection group for the request.</summary>
871 <returns>The name of the connection group for this request. The default value is <see langword="null"></see>.</returns>
873 <member name="P:System.Net.HttpWebRequest.ContentLength">
874 <summary>Gets or sets the <see langword="Content-length"></see> HTTP header.</summary>
875 <returns>The number of bytes of data to send to the Internet resource. The default is -1, which indicates the property has not been set and that there is no request data to send.</returns>
876 <exception cref="T:System.InvalidOperationException">The request has been started by calling the <see cref="System.Net.HttpWebRequest.GetRequestStream"></see>, <see cref="System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see>, <see cref="System.Net.HttpWebRequest.GetResponse"></see>, or <see cref="System.Net.HttpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see> method.</exception>
877 <exception cref="T:System.ArgumentOutOfRangeException">The new <see cref="System.Net.HttpWebRequest.ContentLength"></see> value is less than 0.</exception>
879 <member name="P:System.Net.HttpWebRequest.ContentType">
880 <summary>Gets or sets the value of the <see langword="Content-type"></see> HTTP header.</summary>
881 <returns>The value of the <see langword="Content-type"></see> HTTP header. The default value is <see langword="null"></see>.</returns>
883 <member name="P:System.Net.HttpWebRequest.ContinueDelegate">
884 <summary>Gets or sets the delegate method called when an HTTP 100-continue response is received from the Internet resource.</summary>
885 <returns>A delegate that implements the callback method that executes when an HTTP Continue response is returned from the Internet resource. The default value is <see langword="null"></see>.</returns>
887 <member name="P:System.Net.HttpWebRequest.ContinueTimeout">
888 <summary>Gets or sets a timeout, in milliseconds, to wait until the 100-Continue is received from the server.</summary>
889 <returns>The timeout, in milliseconds, to wait until the 100-Continue is received.</returns>
891 <member name="P:System.Net.HttpWebRequest.CookieContainer">
892 <summary>Gets or sets the cookies associated with the request.</summary>
893 <returns>A <see cref="T:System.Net.CookieContainer"></see> that contains the cookies associated with this request.</returns>
895 <member name="P:System.Net.HttpWebRequest.Credentials">
896 <summary>Gets or sets authentication information for the request.</summary>
897 <returns>An <see cref="T:System.Net.ICredentials"></see> that contains the authentication credentials associated with the request. The default is <see langword="null"></see>.</returns>
899 <member name="P:System.Net.HttpWebRequest.Date">
900 <summary>Get or set the <see langword="Date"></see> HTTP header value to use in an HTTP request.</summary>
901 <returns>The Date header value in the HTTP request.</returns>
903 <member name="P:System.Net.HttpWebRequest.DefaultCachePolicy">
904 <summary>Gets or sets the default cache policy for this request.</summary>
905 <returns>A <see cref="T:System.Net.Cache.HttpRequestCachePolicy"></see> that specifies the cache policy in effect for this request when no other policy is applicable.</returns>
907 <member name="P:System.Net.HttpWebRequest.DefaultMaximumErrorResponseLength">
908 <summary>Gets or sets the default maximum length of an HTTP error response.</summary>
909 <returns>The default maximum length of an HTTP error response.</returns>
910 <exception cref="T:System.ArgumentOutOfRangeException">The value is less than 0 and is not equal to -1.</exception>
912 <member name="P:System.Net.HttpWebRequest.DefaultMaximumResponseHeadersLength">
913 <summary>Gets or sets the default for the <see cref="P:System.Net.HttpWebRequest.MaximumResponseHeadersLength"></see> property.</summary>
914 <returns>The length, in kilobytes (1024 bytes), of the default maximum for response headers received. The default configuration file sets this value to 64 kilobytes.</returns>
915 <exception cref="T:System.ArgumentOutOfRangeException">The value is not equal to -1 and is less than zero.</exception>
917 <member name="M:System.Net.HttpWebRequest.EndGetRequestStream(System.IAsyncResult,System.Net.TransportContext@)">
918 <summary>Ends an asynchronous request for a <see cref="T:System.IO.Stream"></see> object to use to write data and outputs the <see cref="T:System.Net.TransportContext"></see> associated with the stream.</summary>
919 <param name="asyncResult">The pending request for a stream.</param>
920 <param name="context"></param>
921 <returns>A <see cref="T:System.IO.Stream"></see> to use to write request data.</returns>
922 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not returned by the current instance from a call to <see cref="System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see>.</exception>
923 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is <see langword="null"></see>.</exception>
924 <exception cref="T:System.InvalidOperationException">This method was called previously using <paramref name="asyncResult">asyncResult</paramref>.</exception>
925 <exception cref="T:System.IO.IOException">The request did not complete, and no stream is available.</exception>
926 <exception cref="T:System.Net.WebException"><see cref="System.Net.HttpWebRequest.Abort"></see> was previously called.
928 An error occurred while processing the request.</exception>
930 <member name="M:System.Net.HttpWebRequest.EndGetRequestStream(System.IAsyncResult)">
931 <summary>Ends an asynchronous request for a <see cref="T:System.IO.Stream"></see> object to use to write data.</summary>
932 <param name="asyncResult">The pending request for a stream.</param>
933 <returns>A <see cref="T:System.IO.Stream"></see> to use to write request data.</returns>
934 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is <see langword="null"></see>.</exception>
935 <exception cref="T:System.IO.IOException">The request did not complete, and no stream is available.</exception>
936 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not returned by the current instance from a call to <see cref="System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see>.</exception>
937 <exception cref="T:System.InvalidOperationException">This method was called previously using <paramref name="asyncResult">asyncResult</paramref>.</exception>
938 <exception cref="T:System.Net.WebException"><see cref="System.Net.HttpWebRequest.Abort"></see> was previously called.
940 An error occurred while processing the request.</exception>
942 <member name="M:System.Net.HttpWebRequest.EndGetResponse(System.IAsyncResult)">
943 <summary>Ends an asynchronous request to an Internet resource.</summary>
944 <param name="asyncResult">The pending request for a response.</param>
945 <returns>A <see cref="T:System.Net.WebResponse"></see> that contains the response from the Internet resource.</returns>
946 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is <see langword="null"></see>.</exception>
947 <exception cref="T:System.InvalidOperationException">This method was called previously using <paramref name="asyncResult.">asyncResult.</paramref>
949 The <see cref="System.Net.HttpWebRequest.ContentLength"></see> property is greater than 0 but the data has not been written to the request stream.</exception>
950 <exception cref="T:System.Net.WebException"><see cref="System.Net.HttpWebRequest.Abort"></see> was previously called.
952 An error occurred while processing the request.</exception>
953 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not returned by the current instance from a call to <see cref="System.Net.HttpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see>.</exception>
955 <member name="P:System.Net.HttpWebRequest.Expect">
956 <summary>Gets or sets the value of the <see langword="Expect"></see> HTTP header.</summary>
957 <returns>The contents of the <see langword="Expect"></see> HTTP header. The default value is <see langword="null"></see>.
959 The value for this property is stored in <see cref="T:System.Net.WebHeaderCollection"></see>. If WebHeaderCollection is set, the property value is lost. </returns>
960 <exception cref="T:System.ArgumentException"><see langword="Expect"></see> is set to a string that contains &quot;100-continue&quot; as a substring.</exception>
962 <member name="M:System.Net.HttpWebRequest.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
963 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> with the data required to serialize the target object.</summary>
964 <param name="serializationInfo">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to populate with data.</param>
965 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that specifies the destination for this serialization.</param>
967 <member name="M:System.Net.HttpWebRequest.GetRequestStream">
968 <summary>Gets a <see cref="T:System.IO.Stream"></see> object to use to write request data.</summary>
969 <returns>A <see cref="T:System.IO.Stream"></see> to use to write request data.</returns>
970 <exception cref="T:System.Net.ProtocolViolationException">The <see cref="System.Net.HttpWebRequest.Method"></see> property is GET or HEAD.
972 <see cref="System.Net.HttpWebRequest.KeepAlive"></see> is <see langword="true"></see>, <see cref="System.Net.HttpWebRequest.AllowWriteStreamBuffering"></see> is <see langword="false"></see>, <see cref="System.Net.HttpWebRequest.ContentLength"></see> is -1, <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="false"></see>, and <see cref="System.Net.HttpWebRequest.Method"></see> is POST or PUT.</exception>
973 <exception cref="T:System.InvalidOperationException">The <see cref="System.Net.HttpWebRequest.GetRequestStream"></see> method is called more than once.
975 <see cref="System.Net.HttpWebRequest.TransferEncoding"></see> is set to a value and <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="false"></see>.</exception>
976 <exception cref="T:System.NotSupportedException">The request cache validator indicated that the response for this request can be served from the cache; however, requests that write data must not use the cache. This exception can occur if you are using a custom cache validator that is incorrectly implemented.</exception>
977 <exception cref="T:System.Net.WebException"><see cref="System.Net.HttpWebRequest.Abort"></see> was previously called.
979 The time-out period for the request expired.
981 An error occurred while processing the request.</exception>
982 <exception cref="T:System.ObjectDisposedException">In a .NET Compact Framework application, a request stream with zero content length was not obtained and closed correctly. For more information about handling zero content length requests, see Network Programming in the .NET Compact Framework.</exception>
984 <member name="M:System.Net.HttpWebRequest.GetRequestStream(System.Net.TransportContext@)">
985 <summary>Gets a <see cref="T:System.IO.Stream"></see> object to use to write request data and outputs the <see cref="T:System.Net.TransportContext"></see> associated with the stream.</summary>
986 <param name="context">The <see cref="T:System.Net.TransportContext"></see> for the <see cref="T:System.IO.Stream"></see>.</param>
987 <returns>A <see cref="T:System.IO.Stream"></see> to use to write request data.</returns>
988 <exception cref="T:System.Exception">The <see cref="System.Net.HttpWebRequest.GetRequestStream"></see> method was unable to obtain the <see cref="System.IO.Stream"></see>.</exception>
989 <exception cref="T:System.InvalidOperationException">The <see cref="System.Net.HttpWebRequest.GetRequestStream"></see> method is called more than once.
991 <see cref="System.Net.HttpWebRequest.TransferEncoding"></see> is set to a value and <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="false"></see>.</exception>
992 <exception cref="T:System.NotSupportedException">The request cache validator indicated that the response for this request can be served from the cache; however, requests that write data must not use the cache. This exception can occur if you are using a custom cache validator that is incorrectly implemented.</exception>
993 <exception cref="T:System.Net.ProtocolViolationException">The <see cref="System.Net.HttpWebRequest.Method"></see> property is GET or HEAD.
995 <see cref="System.Net.HttpWebRequest.KeepAlive"></see> is <see langword="true"></see>, <see cref="System.Net.HttpWebRequest.AllowWriteStreamBuffering"></see> is <see langword="false"></see>, <see cref="System.Net.HttpWebRequest.ContentLength"></see> is -1, <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="false"></see>, and <see cref="System.Net.HttpWebRequest.Method"></see> is POST or PUT.</exception>
996 <exception cref="T:System.Net.WebException"><see cref="System.Net.HttpWebRequest.Abort"></see> was previously called.
998 The time-out period for the request expired.
1000 An error occurred while processing the request.</exception>
1002 <member name="M:System.Net.HttpWebRequest.GetResponse">
1003 <summary>Returns a response from an Internet resource.</summary>
1004 <returns>A <see cref="T:System.Net.WebResponse"></see> that contains the response from the Internet resource.</returns>
1005 <exception cref="T:System.InvalidOperationException">The stream is already in use by a previous call to <see cref="System.Net.HttpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see>.
1007 <see cref="System.Net.HttpWebRequest.TransferEncoding"></see> is set to a value and <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="false"></see>.</exception>
1008 <exception cref="T:System.Net.ProtocolViolationException"><see cref="System.Net.HttpWebRequest.Method"></see> is GET or HEAD, and either <see cref="System.Net.HttpWebRequest.ContentLength"></see> is greater or equal to zero or <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="true"></see>.
1010 <see cref="System.Net.HttpWebRequest.KeepAlive"></see> is <see langword="true"></see>, <see cref="System.Net.HttpWebRequest.AllowWriteStreamBuffering"></see> is <see langword="false"></see>, <see cref="System.Net.HttpWebRequest.ContentLength"></see> is -1, <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="false"></see>, and <see cref="System.Net.HttpWebRequest.Method"></see> is POST or PUT.
1012 The <see cref="System.Net.HttpWebRequest"></see> has an entity body but the <see cref="System.Net.HttpWebRequest.GetResponse"></see> method is called without calling the <see cref="System.Net.HttpWebRequest.GetRequestStream"></see> method.
1014 The <see cref="System.Net.HttpWebRequest.ContentLength"></see> is greater than zero, but the application does not write all of the promised data.</exception>
1015 <exception cref="T:System.NotSupportedException">The request cache validator indicated that the response for this request can be served from the cache; however, this request includes data to be sent to the server. Requests that send data must not use the cache. This exception can occur if you are using a custom cache validator that is incorrectly implemented.</exception>
1016 <exception cref="T:System.Net.WebException"><see cref="System.Net.HttpWebRequest.Abort"></see> was previously called.
1018 The time-out period for the request expired.
1020 An error occurred while processing the request.</exception>
1022 <member name="P:System.Net.HttpWebRequest.HaveResponse">
1023 <summary>Gets a value that indicates whether a response has been received from an Internet resource.</summary>
1024 <returns><see langword="true"></see> if a response has been received; otherwise, <see langword="false"></see>.</returns>
1026 <member name="P:System.Net.HttpWebRequest.Headers">
1027 <summary>Specifies a collection of the name/value pairs that make up the HTTP headers.</summary>
1028 <returns>A <see cref="T:System.Net.WebHeaderCollection"></see> that contains the name/value pairs that make up the headers for the HTTP request.</returns>
1029 <exception cref="T:System.InvalidOperationException">The request has been started by calling the <see cref="System.Net.HttpWebRequest.GetRequestStream"></see>, <see cref="System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see>, <see cref="System.Net.HttpWebRequest.GetResponse"></see>, or <see cref="System.Net.HttpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see> method.</exception>
1031 <member name="P:System.Net.HttpWebRequest.Host">
1032 <summary>Get or set the Host header value to use in an HTTP request independent from the request URI.</summary>
1033 <returns>The Host header value in the HTTP request.</returns>
1034 <exception cref="T:System.ArgumentNullException">The Host header cannot be set to <see langword="null"></see>.</exception>
1035 <exception cref="T:System.ArgumentException">The Host header cannot be set to an invalid value.</exception>
1036 <exception cref="T:System.InvalidOperationException">The Host header cannot be set after the <see cref="System.Net.HttpWebRequest"></see> has already started to be sent.</exception>
1038 <member name="P:System.Net.HttpWebRequest.IfModifiedSince">
1039 <summary>Gets or sets the value of the <see langword="If-Modified-Since"></see> HTTP header.</summary>
1040 <returns>A <see cref="T:System.DateTime"></see> that contains the contents of the <see langword="If-Modified-Since"></see> HTTP header. The default value is the current date and time.</returns>
1042 <member name="P:System.Net.HttpWebRequest.KeepAlive">
1043 <summary>Gets or sets a value that indicates whether to make a persistent connection to the Internet resource.</summary>
1044 <returns><see langword="true"></see> if the request to the Internet resource should contain a <see langword="Connection"></see> HTTP header with the value Keep-alive; otherwise, <see langword="false"></see>. The default is <see langword="true"></see>.</returns>
1046 <member name="P:System.Net.HttpWebRequest.MaximumAutomaticRedirections">
1047 <summary>Gets or sets the maximum number of redirects that the request follows.</summary>
1048 <returns>The maximum number of redirection responses that the request follows. The default value is 50.</returns>
1049 <exception cref="T:System.ArgumentException">The value is set to 0 or less.</exception>
1051 <member name="P:System.Net.HttpWebRequest.MaximumResponseHeadersLength">
1052 <summary>Gets or sets the maximum allowed length of the response headers.</summary>
1053 <returns>The length, in kilobytes (1024 bytes), of the response headers.</returns>
1054 <exception cref="T:System.InvalidOperationException">The property is set after the request has already been submitted.</exception>
1055 <exception cref="T:System.ArgumentOutOfRangeException">The value is less than 0 and is not equal to -1.</exception>
1057 <member name="P:System.Net.HttpWebRequest.MediaType">
1058 <summary>Gets or sets the media type of the request.</summary>
1059 <returns>The media type of the request. The default value is <see langword="null"></see>.</returns>
1061 <member name="P:System.Net.HttpWebRequest.Method">
1062 <summary>Gets or sets the method for the request.</summary>
1063 <returns>The request method to use to contact the Internet resource. The default value is GET.</returns>
1064 <exception cref="T:System.ArgumentException">No method is supplied.
1066 The method string contains invalid characters.</exception>
1068 <member name="P:System.Net.HttpWebRequest.Pipelined">
1069 <summary>Gets or sets a value that indicates whether to pipeline the request to the Internet resource.</summary>
1070 <returns><see langword="true"></see> if the request should be pipelined; otherwise, <see langword="false"></see>. The default is <see langword="true"></see>.</returns>
1072 <member name="P:System.Net.HttpWebRequest.PreAuthenticate">
1073 <summary>Gets or sets a value that indicates whether to send an Authorization header with the request.</summary>
1074 <returns><see langword="true"></see> to send an HTTP Authorization header with requests after authentication has taken place; otherwise, <see langword="false"></see>. The default is <see langword="false"></see>.</returns>
1076 <member name="P:System.Net.HttpWebRequest.ProtocolVersion">
1077 <summary>Gets or sets the version of HTTP to use for the request.</summary>
1078 <returns>The HTTP version to use for the request. The default is <see cref="F:System.Net.HttpVersion.Version11"></see>.</returns>
1079 <exception cref="T:System.ArgumentException">The HTTP version is set to a value other than 1.0 or 1.1.</exception>
1081 <member name="P:System.Net.HttpWebRequest.Proxy">
1082 <summary>Gets or sets proxy information for the request.</summary>
1083 <returns>The <see cref="T:System.Net.IWebProxy"></see> object to use to proxy the request. The default value is set by calling the <see cref="P:System.Net.GlobalProxySelection.Select"></see> property.</returns>
1084 <exception cref="T:System.ArgumentNullException"><see cref="System.Net.HttpWebRequest.Proxy"></see> is set to <see langword="null"></see>.</exception>
1085 <exception cref="T:System.InvalidOperationException">The request has been started by calling <see cref="System.Net.HttpWebRequest.GetRequestStream"></see>, <see cref="System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see>, <see cref="System.Net.HttpWebRequest.GetResponse"></see>, or <see cref="System.Net.HttpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see>.</exception>
1086 <exception cref="T:System.Security.SecurityException">The caller does not have permission for the requested operation.</exception>
1088 <member name="P:System.Net.HttpWebRequest.ReadWriteTimeout">
1089 <summary>Gets or sets a time-out in milliseconds when writing to or reading from a stream.</summary>
1090 <returns>The number of milliseconds before the writing or reading times out. The default value is 300,000 milliseconds (5 minutes).</returns>
1091 <exception cref="T:System.InvalidOperationException">The request has already been sent.</exception>
1092 <exception cref="T:System.ArgumentOutOfRangeException">The value specified for a set operation is less than or equal to zero and is not equal to <see cref="System.Threading.Timeout.Infinite"></see></exception>
1094 <member name="P:System.Net.HttpWebRequest.Referer">
1095 <summary>Gets or sets the value of the <see langword="Referer"></see> HTTP header.</summary>
1096 <returns>The value of the <see langword="Referer"></see> HTTP header. The default value is <see langword="null"></see>.</returns>
1098 <member name="P:System.Net.HttpWebRequest.RequestUri">
1099 <summary>Gets the original Uniform Resource Identifier (URI) of the request.</summary>
1100 <returns>A <see cref="T:System.Uri"></see> that contains the URI of the Internet resource passed to the <see cref="M:System.Net.WebRequest.Create(System.String)"></see> method.</returns>
1102 <member name="P:System.Net.HttpWebRequest.SendChunked">
1103 <summary>Gets or sets a value that indicates whether to send data in segments to the Internet resource.</summary>
1104 <returns><see langword="true"></see> to send data to the Internet resource in segments; otherwise, <see langword="false"></see>. The default value is <see langword="false"></see>.</returns>
1105 <exception cref="T:System.InvalidOperationException">The request has been started by calling the <see cref="System.Net.HttpWebRequest.GetRequestStream"></see>, <see cref="System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see>, <see cref="System.Net.HttpWebRequest.GetResponse"></see>, or <see cref="System.Net.HttpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see> method.</exception>
1107 <member name="P:System.Net.HttpWebRequest.ServerCertificateValidationCallback">
1108 <summary>Gets or sets a callback function to validate the server certificate.</summary>
1109 <returns>A callback function to validate the server certificate.</returns>
1111 <member name="P:System.Net.HttpWebRequest.ServicePoint">
1112 <summary>Gets the service point to use for the request.</summary>
1113 <returns>A <see cref="T:System.Net.ServicePoint"></see> that represents the network connection to the Internet resource.</returns>
1115 <member name="P:System.Net.HttpWebRequest.SupportsCookieContainer">
1116 <summary>Gets a value that indicates whether the request provides support for a <see cref="T:System.Net.CookieContainer"></see>.</summary>
1117 <returns><see langword="true"></see> if the request provides support for a <see cref="T:System.Net.CookieContainer"></see>; otherwise, <see langword="false"></see>.</returns>
1119 <member name="P:System.Net.HttpWebRequest.Timeout">
1120 <summary>Gets or sets the time-out value in milliseconds for the <see cref="M:System.Net.HttpWebRequest.GetResponse"></see> and <see cref="M:System.Net.HttpWebRequest.GetRequestStream"></see> methods.</summary>
1121 <returns>The number of milliseconds to wait before the request times out. The default value is 100,000 milliseconds (100 seconds).</returns>
1122 <exception cref="T:System.ArgumentOutOfRangeException">The value specified is less than zero and is not <see cref="System.Threading.Timeout.Infinite"></see>.</exception>
1124 <member name="P:System.Net.HttpWebRequest.TransferEncoding">
1125 <summary>Gets or sets the value of the <see langword="Transfer-encoding"></see> HTTP header.</summary>
1126 <returns>The value of the <see langword="Transfer-encoding"></see> HTTP header. The default value is <see langword="null"></see>.</returns>
1127 <exception cref="T:System.InvalidOperationException"><see cref="System.Net.HttpWebRequest.TransferEncoding"></see> is set when <see cref="System.Net.HttpWebRequest.SendChunked"></see> is <see langword="false"></see>.</exception>
1128 <exception cref="T:System.ArgumentException"><see cref="System.Net.HttpWebRequest.TransferEncoding"></see> is set to the value &quot;Chunked&quot;.</exception>
1130 <member name="P:System.Net.HttpWebRequest.UnsafeAuthenticatedConnectionSharing">
1131 <summary>Gets or sets a value that indicates whether to allow high-speed NTLM-authenticated connection sharing.</summary>
1132 <returns><see langword="true"></see> to keep the authenticated connection open; otherwise, <see langword="false"></see>.</returns>
1134 <member name="P:System.Net.HttpWebRequest.UseDefaultCredentials">
1135 <summary>Gets or sets a <see cref="T:System.Boolean"></see> value that controls whether default credentials are sent with requests.</summary>
1136 <returns><see langword="true"></see> if the default credentials are used; otherwise <see langword="false"></see>. The default value is <see langword="false"></see>.</returns>
1137 <exception cref="T:System.InvalidOperationException">You attempted to set this property after the request was sent.</exception>
1139 <member name="P:System.Net.HttpWebRequest.UserAgent">
1140 <summary>Gets or sets the value of the <see langword="User-agent"></see> HTTP header.</summary>
1141 <returns>The value of the <see langword="User-agent"></see> HTTP header. The default value is <see langword="null"></see>.
1143 The value for this property is stored in <see cref="T:System.Net.WebHeaderCollection"></see>. If WebHeaderCollection is set, the property value is lost. </returns>
1145 <member name="M:System.Net.HttpWebRequest.System#Runtime#Serialization#ISerializable#GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
1146 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> with the data needed to serialize the target object.</summary>
1147 <param name="serializationInfo">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to populate with data.</param>
1148 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that specifies the destination for this serialization.</param>
1150 <member name="T:System.Net.HttpContinueDelegate">
1151 <summary>Represents the method that notifies callers when a continue response is received by the client.</summary>
1152 <param name="StatusCode">The numeric value of the HTTP status from the server.</param>
1153 <param name="httpHeaders">The headers returned with the 100-continue response from the server.</param>
1155 <member name="T:System.Net.Cache.HttpRequestCachePolicy">
1156 <summary>Defines an application&#39;s caching requirements for resources obtained by using <see cref="T:System.Net.HttpWebRequest"></see> objects.</summary>
1158 <member name="M:System.Net.Cache.HttpRequestCachePolicy.#ctor">
1159 <summary>Initializes a new instance of the <see cref="T:System.Net.Cache.HttpRequestCachePolicy"></see> class.</summary>
1161 <member name="M:System.Net.Cache.HttpRequestCachePolicy.#ctor(System.DateTime)">
1162 <summary>Initializes a new instance of the <see cref="T:System.Net.Cache.HttpRequestCachePolicy"></see> class using the specified cache synchronization date.</summary>
1163 <param name="cacheSyncDate">A <see cref="T:System.DateTime"></see> object that specifies the time when resources stored in the cache must be revalidated.</param>
1165 <member name="M:System.Net.Cache.HttpRequestCachePolicy.#ctor(System.Net.Cache.HttpRequestCacheLevel)">
1166 <summary>Initializes a new instance of the <see cref="T:System.Net.Cache.HttpRequestCachePolicy"></see> class using the specified cache policy.</summary>
1167 <param name="level">An <see cref="T:System.Net.Cache.HttpRequestCacheLevel"></see> value.</param>
1169 <member name="M:System.Net.Cache.HttpRequestCachePolicy.#ctor(System.Net.Cache.HttpCacheAgeControl,System.TimeSpan)">
1170 <summary>Initializes a new instance of the <see cref="T:System.Net.Cache.HttpRequestCachePolicy"></see> class using the specified age control and time values.</summary>
1171 <param name="cacheAgeControl">One of the following <see cref="T:System.Net.Cache.HttpCacheAgeControl"></see> enumeration values: <see cref="F:System.Net.Cache.HttpCacheAgeControl.MaxAge"></see>, <see cref="F:System.Net.Cache.HttpCacheAgeControl.MaxStale"></see>, or <see cref="F:System.Net.Cache.HttpCacheAgeControl.MinFresh"></see>.</param>
1172 <param name="ageOrFreshOrStale">A <see cref="T:System.TimeSpan"></see> value that specifies an amount of time.</param>
1173 <exception cref="T:System.ArgumentException">The value specified for the <paramref name="cacheAgeControl">cacheAgeControl</paramref> parameter cannot be used with this constructor.</exception>
1175 <member name="M:System.Net.Cache.HttpRequestCachePolicy.#ctor(System.Net.Cache.HttpCacheAgeControl,System.TimeSpan,System.TimeSpan)">
1176 <summary>Initializes a new instance of the <see cref="T:System.Net.Cache.HttpRequestCachePolicy"></see> class using the specified maximum age, age control value, and time value.</summary>
1177 <param name="cacheAgeControl">An <see cref="T:System.Net.Cache.HttpCacheAgeControl"></see> value.</param>
1178 <param name="maxAge">A <see cref="T:System.TimeSpan"></see> value that specifies the maximum age for resources.</param>
1179 <param name="freshOrStale">A <see cref="T:System.TimeSpan"></see> value that specifies an amount of time.</param>
1180 <exception cref="T:System.ArgumentException">The value specified for the <paramref name="cacheAgeControl">cacheAgeControl</paramref> parameter is not valid.</exception>
1182 <member name="M:System.Net.Cache.HttpRequestCachePolicy.#ctor(System.Net.Cache.HttpCacheAgeControl,System.TimeSpan,System.TimeSpan,System.DateTime)">
1183 <summary>Initializes a new instance of the <see cref="T:System.Net.Cache.HttpRequestCachePolicy"></see> class using the specified maximum age, age control value, time value, and cache synchronization date.</summary>
1184 <param name="cacheAgeControl">An <see cref="T:System.Net.Cache.HttpCacheAgeControl"></see> value.</param>
1185 <param name="maxAge">A <see cref="T:System.TimeSpan"></see> value that specifies the maximum age for resources.</param>
1186 <param name="freshOrStale">A <see cref="T:System.TimeSpan"></see> value that specifies an amount of time.</param>
1187 <param name="cacheSyncDate">A <see cref="T:System.DateTime"></see> object that specifies the time when resources stored in the cache must be revalidated.</param>
1189 <member name="P:System.Net.Cache.HttpRequestCachePolicy.CacheSyncDate">
1190 <summary>Gets the cache synchronization date for this instance.</summary>
1191 <returns>A <see cref="T:System.DateTime"></see> value set to the date specified when this instance was created. If no date was specified, this property&#39;s value is <see cref="F:System.DateTime.MinValue"></see>.</returns>
1193 <member name="P:System.Net.Cache.HttpRequestCachePolicy.Level">
1194 <summary>Gets the <see cref="T:System.Net.Cache.HttpRequestCacheLevel"></see> value that was specified when this instance was created.</summary>
1195 <returns>A <see cref="T:System.Net.Cache.HttpRequestCacheLevel"></see> value that specifies the cache behavior for resources that were obtained using <see cref="T:System.Net.HttpWebRequest"></see> objects.</returns>
1197 <member name="P:System.Net.Cache.HttpRequestCachePolicy.MaxAge">
1198 <summary>Gets the maximum age permitted for a resource returned from the cache.</summary>
1199 <returns>A <see cref="T:System.TimeSpan"></see> value that is set to the maximum age value specified when this instance was created. If no date was specified, this property&#39;s value is <see cref="F:System.DateTime.MinValue"></see>.</returns>
1201 <member name="P:System.Net.Cache.HttpRequestCachePolicy.MaxStale">
1202 <summary>Gets the maximum staleness value that is permitted for a resource returned from the cache.</summary>
1203 <returns>A <see cref="T:System.TimeSpan"></see> value that is set to the maximum staleness value specified when this instance was created. If no date was specified, this property&#39;s value is <see cref="F:System.DateTime.MinValue"></see>.</returns>
1205 <member name="P:System.Net.Cache.HttpRequestCachePolicy.MinFresh">
1206 <summary>Gets the minimum freshness that is permitted for a resource returned from the cache.</summary>
1207 <returns>A <see cref="T:System.TimeSpan"></see> value that specifies the minimum freshness specified when this instance was created. If no date was specified, this property&#39;s value is <see cref="F:System.DateTime.MinValue"></see>.</returns>
1209 <member name="M:System.Net.Cache.HttpRequestCachePolicy.ToString">
1210 <summary>Returns a string representation of this instance.</summary>
1211 <returns>A <see cref="T:System.String"></see> value that contains the property values for this instance.</returns>
1213 <member name="T:System.Net.Cache.HttpRequestCacheLevel">
1214 <summary>Specifies caching behavior for resources obtained using the Hypertext Transfer protocol (HTTP).</summary>
1216 <member name="F:System.Net.Cache.HttpRequestCacheLevel.BypassCache">
1217 <summary>Satisfies a request by using the server. No entries are taken from caches, added to caches, or removed from caches between the client and server. No entries are taken from caches, added to caches, or removed from caches between the client and server. This is the default cache behavior specified in the machine configuration file that ships with the .NET Framework.</summary>
1220 <member name="F:System.Net.Cache.HttpRequestCacheLevel.CacheIfAvailable">
1221 <summary>Satisfies a request for a resource from the cache if the resource is available; otherwise, sends a request for a resource to the server. If the requested item is available in any cache between the client and the server, the request might be satisfied by the intermediate cache.</summary>
1224 <member name="F:System.Net.Cache.HttpRequestCacheLevel.CacheOnly">
1225 <summary>Satisfies a request using the locally cached resource; does not send a request for an item that is not in the cache. When this cache policy level is specified, a <see cref="T:System.Net.WebException"></see> exception is thrown if the item is not in the client cache.</summary>
1228 <member name="F:System.Net.Cache.HttpRequestCacheLevel.CacheOrNextCacheOnly">
1229 <summary>Satisfies a request for a resource either from the local computer&#39;s cache or a remote cache on the local area network. If the request cannot be satisfied, a <see cref="T:System.Net.WebException"></see> exception is thrown. In the HTTP caching protocol, this is achieved using the <see langword="only-if-cached"></see> cache control directive.</summary>
1232 <member name="F:System.Net.Cache.HttpRequestCacheLevel.Default">
1233 <summary>Satisfies a request for a resource either by using the cached copy of the resource or by sending a request for the resource to the server. The action taken is determined by the current cache policy and the age of the content in the cache. This is the cache level that should be used by most applications.</summary>
1236 <member name="F:System.Net.Cache.HttpRequestCacheLevel.NoCacheNoStore">
1237 <summary>Never satisfies a request by using resources from the cache and does not cache resources. If the resource is present in the local cache, it is removed. This policy level indicates to intermediate caches that they should remove the resource. In the HTTP caching protocol, this is achieved using the no-cache cache control directive.</summary>
1240 <member name="F:System.Net.Cache.HttpRequestCacheLevel.Refresh">
1241 <summary>Satisfies a request by using the server or a cache other than the local cache. Before the request can be satisfied by an intermediate cache, that cache must revalidate its cached entry with the server. In the HTTP caching protocol, this is achieved using the max-age = 0 cache control directive and the no-cache <see langword="Pragma"></see> header.</summary>
1244 <member name="F:System.Net.Cache.HttpRequestCacheLevel.Reload">
1245 <summary>Satisfies a request by using the server. The response might be saved in the cache. In the HTTP caching protocol, this is achieved using the no-cache cache control directive and the no-cache <see langword="Pragma"></see> header.</summary>
1248 <member name="F:System.Net.Cache.HttpRequestCacheLevel.Revalidate">
1249 <summary>Compares the copy of the resource in the cache with the copy on the server. If the copy on the server is newer, it is used to satisfy the request and replaces the copy in the cache. If the copy in the cache is the same as the server copy, the cached copy is used. In the HTTP caching protocol, this is achieved using a conditional request.</summary>
1252 <member name="T:System.Net.Cache.HttpCacheAgeControl">
1253 <summary>Specifies the meaning of time values that control caching behavior for resources obtained using <see cref="T:System.Net.HttpWebRequest"></see> objects.</summary>
1255 <member name="F:System.Net.Cache.HttpCacheAgeControl.MaxAge">
1256 <summary>Content can be taken from the cache until it is older than the age specified with this value.</summary>
1259 <member name="F:System.Net.Cache.HttpCacheAgeControl.MaxAgeAndMaxStale">
1260 <summary><see cref="P:System.Net.Cache.HttpRequestCachePolicy.MaxAge"></see> and <see cref="P:System.Net.Cache.HttpRequestCachePolicy.MaxStale"></see>.</summary>
1263 <member name="F:System.Net.Cache.HttpCacheAgeControl.MaxAgeAndMinFresh">
1264 <summary><see cref="P:System.Net.Cache.HttpRequestCachePolicy.MaxAge"></see> and <see cref="P:System.Net.Cache.HttpRequestCachePolicy.MinFresh"></see>.</summary>
1267 <member name="F:System.Net.Cache.HttpCacheAgeControl.MaxStale">
1268 <summary>Content can be taken from the cache after it has expired, until the time specified with this value elapses.</summary>
1271 <member name="F:System.Net.Cache.HttpCacheAgeControl.MinFresh">
1272 <summary>Content can be taken from the cache if the time remaining before expiration is greater than or equal to the time specified with this value.</summary>
1275 <member name="F:System.Net.Cache.HttpCacheAgeControl.None">
1276 <summary>For internal use only. The Framework will throw an <see cref="T:System.ArgumentException"></see> if you try to use this member.</summary>
1279 <member name="T:System.Net.Authorization">
1280 <summary>Contains an authentication message for an Internet server.</summary>
1282 <member name="M:System.Net.Authorization.#ctor(System.String)">
1283 <summary>Creates a new instance of the <see cref="T:System.Net.Authorization"></see> class with the specified authorization message.</summary>
1284 <param name="token">The encrypted authorization message expected by the server.</param>
1286 <member name="M:System.Net.Authorization.#ctor(System.String,System.Boolean)">
1287 <summary>Creates a new instance of the <see cref="T:System.Net.Authorization"></see> class with the specified authorization message and completion status.</summary>
1288 <param name="token">The encrypted authorization message expected by the server.</param>
1289 <param name="finished">The completion status of the authorization attempt. <see langword="true"></see> if the authorization attempt is complete; otherwise, <see langword="false"></see>.</param>
1291 <member name="M:System.Net.Authorization.#ctor(System.String,System.Boolean,System.String)">
1292 <summary>Creates a new instance of the <see cref="T:System.Net.Authorization"></see> class with the specified authorization message, completion status, and connection group identifier.</summary>
1293 <param name="token">The encrypted authorization message expected by the server.</param>
1294 <param name="finished">The completion status of the authorization attempt. <see langword="true"></see> if the authorization attempt is complete; otherwise, <see langword="false"></see>.</param>
1295 <param name="connectionGroupId">A unique identifier that can be used to create private client-server connections that are bound only to this authentication scheme.</param>
1297 <member name="P:System.Net.Authorization.Complete">
1298 <summary>Gets the completion status of the authorization.</summary>
1299 <returns><see langword="true"></see> if the authentication process is complete; otherwise, <see langword="false"></see>.</returns>
1301 <member name="P:System.Net.Authorization.ConnectionGroupId">
1302 <summary>Gets a unique identifier for user-specific connections.</summary>
1303 <returns>A unique string that associates a connection with an authenticating entity.</returns>
1305 <member name="P:System.Net.Authorization.Message">
1306 <summary>Gets the message returned to the server in response to an authentication challenge.</summary>
1307 <returns>The message that will be returned to the server in response to an authentication challenge.</returns>
1309 <member name="P:System.Net.Authorization.MutuallyAuthenticated">
1310 <summary>Gets or sets a <see cref="T:System.Boolean"></see> value that indicates whether mutual authentication occurred.</summary>
1311 <returns><see langword="true"></see> if both client and server were authenticated; otherwise, <see langword="false"></see>.</returns>
1313 <member name="P:System.Net.Authorization.ProtectionRealm">
1314 <summary>Gets or sets the prefix for Uniform Resource Identifiers (URIs) that can be authenticated with the <see cref="P:System.Net.Authorization.Message"></see> property.</summary>
1315 <returns>An array of strings that contains URI prefixes.</returns>
1317 <member name="T:System.Net.AuthenticationManager">
1318 <summary>Manages the authentication modules called during the client authentication process.</summary>
1320 <member name="M:System.Net.AuthenticationManager.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)">
1321 <summary>Calls each registered authentication module to find the first module that can respond to the authentication request.</summary>
1322 <param name="challenge">The challenge returned by the Internet resource.</param>
1323 <param name="request">The <see cref="T:System.Net.WebRequest"></see> that initiated the authentication challenge.</param>
1324 <param name="credentials">The <see cref="T:System.Net.ICredentials"></see> associated with this request.</param>
1325 <returns>An instance of the <see cref="T:System.Net.Authorization"></see> class containing the result of the authorization attempt. If there is no authentication module to respond to the challenge, this method returns <see langword="null"></see>.</returns>
1326 <exception cref="T:System.ArgumentNullException"><paramref name="challenge">challenge</paramref> is <see langword="null"></see>.
1328 <paramref name="request">request</paramref> is <see langword="null"></see>.
1330 <paramref name="credentials">credentials</paramref> is <see langword="null"></see>.</exception>
1332 <member name="P:System.Net.AuthenticationManager.CredentialPolicy">
1333 <summary>Gets or sets the credential policy to be used for resource requests made using the <see cref="T:System.Net.HttpWebRequest"></see> class.</summary>
1334 <returns>An object that implements the <see cref="T:System.Net.ICredentialPolicy"></see> interface that determines whether credentials are sent with requests. The default value is <see langword="null"></see>.</returns>
1336 <member name="P:System.Net.AuthenticationManager.CustomTargetNameDictionary">
1337 <summary>Gets the dictionary that contains Service Principal Names (SPNs) that are used to identify hosts during Kerberos authentication for requests made using <see cref="T:System.Net.WebRequest"></see> and its derived classes.</summary>
1338 <returns>A writable <see cref="T:System.Collections.Specialized.StringDictionary"></see> that contains the SPN values for keys composed of host information.</returns>
1340 <member name="M:System.Net.AuthenticationManager.PreAuthenticate(System.Net.WebRequest,System.Net.ICredentials)">
1341 <summary>Preauthenticates a request.</summary>
1342 <param name="request">A <see cref="T:System.Net.WebRequest"></see> to an Internet resource.</param>
1343 <param name="credentials">The <see cref="T:System.Net.ICredentials"></see> associated with the request.</param>
1344 <returns>An instance of the <see cref="T:System.Net.Authorization"></see> class if the request can be preauthenticated; otherwise, <see langword="null"></see>. If <paramref name="credentials">credentials</paramref> is <see langword="null"></see>, this method returns <see langword="null"></see>.</returns>
1345 <exception cref="T:System.ArgumentNullException"><paramref name="request">request</paramref> is <see langword="null"></see>.</exception>
1347 <member name="M:System.Net.AuthenticationManager.Register(System.Net.IAuthenticationModule)">
1348 <summary>Registers an authentication module with the authentication manager.</summary>
1349 <param name="authenticationModule">The <see cref="T:System.Net.IAuthenticationModule"></see> to register with the authentication manager.</param>
1350 <exception cref="T:System.ArgumentNullException"><paramref name="authenticationModule">authenticationModule</paramref> is <see langword="null"></see>.</exception>
1352 <member name="P:System.Net.AuthenticationManager.RegisteredModules">
1353 <summary>Gets a list of authentication modules that are registered with the authentication manager.</summary>
1354 <returns>An <see cref="T:System.Collections.IEnumerator"></see> that enables the registered authentication modules to be read.</returns>
1356 <member name="M:System.Net.AuthenticationManager.Unregister(System.Net.IAuthenticationModule)">
1357 <summary>Removes the specified authentication module from the list of registered modules.</summary>
1358 <param name="authenticationModule">The <see cref="T:System.Net.IAuthenticationModule"></see> to remove from the list of registered modules.</param>
1359 <exception cref="T:System.ArgumentNullException"><paramref name="authenticationModule">authenticationModule</paramref> is <see langword="null"></see>.</exception>
1360 <exception cref="T:System.InvalidOperationException">The specified <see cref="System.Net.IAuthenticationModule"></see> is not registered.</exception>
1362 <member name="M:System.Net.AuthenticationManager.Unregister(System.String)">
1363 <summary>Removes authentication modules with the specified authentication scheme from the list of registered modules.</summary>
1364 <param name="authenticationScheme">The authentication scheme of the module to remove.</param>
1365 <exception cref="T:System.ArgumentNullException"><paramref name="authenticationScheme">authenticationScheme</paramref> is <see langword="null"></see>.</exception>
1366 <exception cref="T:System.InvalidOperationException">A module for this authentication scheme is not registered.</exception>
1368 <member name="T:System.Net.GlobalProxySelection">
1369 <summary>Contains a global default proxy instance for all HTTP requests.</summary>
1371 <member name="M:System.Net.GlobalProxySelection.#ctor">
1372 <summary>Initializes a new instance of the <see cref="T:System.Net.GlobalProxySelection"></see> class.</summary>
1374 <member name="M:System.Net.GlobalProxySelection.GetEmptyWebProxy">
1375 <summary>Returns an empty proxy instance.</summary>
1376 <returns>An <see cref="T:System.Net.IWebProxy"></see> that contains no information.</returns>
1378 <member name="P:System.Net.GlobalProxySelection.Select">
1379 <summary>Gets or sets the global HTTP proxy.</summary>
1380 <returns>An <see cref="T:System.Net.IWebProxy"></see> that every call to <see cref="M:System.Net.HttpWebRequest.GetResponse"></see> uses.</returns>
1381 <exception cref="T:System.ArgumentNullException">The value specified for a set operation was <see langword="null"></see>.</exception>
1382 <exception cref="T:System.Security.SecurityException">The caller does not have permission for the requested operation.</exception>
1384 <member name="T:System.Net.FtpWebResponse">
1385 <summary>Encapsulates a File Transfer Protocol (FTP) server&#39;s response to a request.</summary>
1387 <member name="P:System.Net.FtpWebResponse.BannerMessage">
1388 <summary>Gets the message sent by the FTP server when a connection is established prior to logon.</summary>
1389 <returns>A <see cref="T:System.String"></see> that contains the banner message sent by the server; otherwise, <see cref="F:System.String.Empty"></see> if no message is sent.</returns>
1391 <member name="M:System.Net.FtpWebResponse.Close">
1392 <summary>Frees the resources held by the response.</summary>
1394 <member name="P:System.Net.FtpWebResponse.ContentLength">
1395 <summary>Gets the length of the data received from the FTP server.</summary>
1396 <returns>An <see cref="T:System.Int64"></see> value that contains the number of bytes of data received from the FTP server.</returns>
1398 <member name="P:System.Net.FtpWebResponse.ContentType">
1401 <member name="P:System.Net.FtpWebResponse.ExitMessage">
1402 <summary>Gets the message sent by the server when the FTP session is ending.</summary>
1403 <returns>A <see cref="T:System.String"></see> that contains the exit message sent by the server; otherwise, <see cref="F:System.String.Empty"></see> if no message is sent.</returns>
1405 <member name="M:System.Net.FtpWebResponse.GetResponseStream">
1406 <summary>Retrieves the stream that contains response data sent from an FTP server.</summary>
1407 <returns>A readable <see cref="T:System.IO.Stream"></see> instance that contains data returned with the response; otherwise, <see cref="F:System.IO.Stream.Null"></see> if no response data was returned by the server.</returns>
1408 <exception cref="T:System.InvalidOperationException">The response did not return a data stream.</exception>
1410 <member name="P:System.Net.FtpWebResponse.Headers">
1411 <summary>Gets an empty <see cref="T:System.Net.WebHeaderCollection"></see> object.</summary>
1412 <returns>An empty <see cref="T:System.Net.WebHeaderCollection"></see> object.</returns>
1414 <member name="P:System.Net.FtpWebResponse.LastModified">
1415 <summary>Gets the date and time that a file on an FTP server was last modified.</summary>
1416 <returns>A <see cref="T:System.DateTime"></see> that contains the last modified date and time for a file.</returns>
1418 <member name="P:System.Net.FtpWebResponse.ResponseUri">
1419 <summary>Gets the URI that sent the response to the request.</summary>
1420 <returns>A <see cref="T:System.Uri"></see> instance that identifies the resource associated with this response.</returns>
1422 <member name="P:System.Net.FtpWebResponse.StatusCode">
1423 <summary>Gets the most recent status code sent from the FTP server.</summary>
1424 <returns>An <see cref="T:System.Net.FtpStatusCode"></see> value that indicates the most recent status code returned with this response.</returns>
1426 <member name="P:System.Net.FtpWebResponse.StatusDescription">
1427 <summary>Gets text that describes a status code sent from the FTP server.</summary>
1428 <returns>A <see cref="T:System.String"></see> instance that contains the status code and message returned with this response.</returns>
1430 <member name="P:System.Net.FtpWebResponse.SupportsHeaders">
1431 <summary>Gets a value that indicates whether the <see cref="P:System.Net.FtpWebResponse.Headers"></see> property is supported by the <see cref="T:System.Net.FtpWebResponse"></see> instance.</summary>
1432 <returns>Returns <see cref="T:System.Boolean"></see>.
1433 <see langword="true"></see> if the <see cref="P:System.Net.FtpWebResponse.Headers"></see> property is supported by the <see cref="T:System.Net.FtpWebResponse"></see> instance; otherwise, <see langword="false"></see>.</returns>
1435 <member name="P:System.Net.FtpWebResponse.WelcomeMessage">
1436 <summary>Gets the message sent by the FTP server when authentication is complete.</summary>
1437 <returns>A <see cref="T:System.String"></see> that contains the welcome message sent by the server; otherwise, <see cref="F:System.String.Empty"></see> if no message is sent.</returns>
1439 <member name="T:System.Net.FtpWebRequest">
1440 <summary>Implements a File Transfer Protocol (FTP) client.</summary>
1442 <member name="M:System.Net.FtpWebRequest.Abort">
1443 <summary>Terminates an asynchronous FTP operation.</summary>
1445 <member name="M:System.Net.FtpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)">
1446 <summary>Begins asynchronously opening a request&#39;s content stream for writing.</summary>
1447 <param name="callback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the operation is complete.</param>
1448 <param name="state">A user-defined object that contains information about the operation. This object is passed to the callback delegate when the operation completes.</param>
1449 <returns>An <see cref="T:System.IAsyncResult"></see> instance that indicates the status of the operation.</returns>
1450 <exception cref="T:System.InvalidOperationException">A previous call to this method or <see cref="System.Net.FtpWebRequest.GetRequestStream"></see> has not yet completed.</exception>
1451 <exception cref="T:System.Net.WebException">A connection to the FTP server could not be established.</exception>
1452 <exception cref="T:System.Net.ProtocolViolationException">The <see cref="System.Net.FtpWebRequest.Method"></see> property is not set to <see cref="System.Net.WebRequestMethods.Ftp.UploadFile"></see>.</exception>
1454 <member name="M:System.Net.FtpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)">
1455 <summary>Begins sending a request and receiving a response from an FTP server asynchronously.</summary>
1456 <param name="callback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the operation is complete.</param>
1457 <param name="state">A user-defined object that contains information about the operation. This object is passed to the callback delegate when the operation completes.</param>
1458 <returns>An <see cref="T:System.IAsyncResult"></see> instance that indicates the status of the operation.</returns>
1459 <exception cref="T:System.InvalidOperationException"><see cref="System.Net.FtpWebRequest.GetResponse"></see> or <see cref="System.Net.FtpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see> has already been called for this instance.</exception>
1461 <member name="P:System.Net.FtpWebRequest.ClientCertificates">
1462 <summary>Gets or sets the certificates used for establishing an encrypted connection to the FTP server.</summary>
1463 <returns>An <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection"></see> object that contains the client certificates.</returns>
1464 <exception cref="T:System.ArgumentNullException">The value specified for a set operation is <see langword="null"></see>.</exception>
1466 <member name="P:System.Net.FtpWebRequest.ConnectionGroupName">
1467 <summary>Gets or sets the name of the connection group that contains the service point used to send the current request.</summary>
1468 <returns>A <see cref="T:System.String"></see> value that contains a connection group name.</returns>
1469 <exception cref="T:System.InvalidOperationException">A new value was specified for this property for a request that is already in progress.</exception>
1471 <member name="P:System.Net.FtpWebRequest.ContentLength">
1472 <summary>Gets or sets a value that is ignored by the <see cref="T:System.Net.FtpWebRequest"></see> class.</summary>
1473 <returns>An <see cref="T:System.Int64"></see> value that should be ignored.</returns>
1475 <member name="P:System.Net.FtpWebRequest.ContentOffset">
1476 <summary>Gets or sets a byte offset into the file being downloaded by this request.</summary>
1477 <returns>An <see cref="T:System.Int64"></see> instance that specifies the file offset, in bytes. The default value is zero.</returns>
1478 <exception cref="T:System.InvalidOperationException">A new value was specified for this property for a request that is already in progress.</exception>
1479 <exception cref="T:System.ArgumentOutOfRangeException">The value specified for this property is less than zero.</exception>
1481 <member name="P:System.Net.FtpWebRequest.ContentType">
1482 <summary>Always throws a <see cref="T:System.NotSupportedException"></see>.</summary>
1483 <returns>Always throws a <see cref="T:System.NotSupportedException"></see>.</returns>
1484 <exception cref="T:System.NotSupportedException">Content type information is not supported for FTP.</exception>
1486 <member name="P:System.Net.FtpWebRequest.Credentials">
1487 <summary>Gets or sets the credentials used to communicate with the FTP server.</summary>
1488 <returns>An <see cref="T:System.Net.ICredentials"></see> instance; otherwise, <see langword="null"></see> if the property has not been set.</returns>
1489 <exception cref="T:System.ArgumentNullException">The value specified for a set operation is <see langword="null"></see>.</exception>
1490 <exception cref="T:System.ArgumentException">An <see cref="System.Net.ICredentials"></see> of a type other than <see cref="System.Net.NetworkCredential"></see> was specified for a set operation.</exception>
1491 <exception cref="T:System.InvalidOperationException">A new value was specified for this property for a request that is already in progress.</exception>
1493 <member name="P:System.Net.FtpWebRequest.DefaultCachePolicy">
1494 <summary>Defines the default cache policy for all FTP requests.</summary>
1495 <returns>A <see cref="T:System.Net.Cache.RequestCachePolicy"></see> that defines the cache policy for FTP requests.</returns>
1496 <exception cref="T:System.ArgumentNullException">The caller tried to set this property to <see langword="null"></see>.</exception>
1498 <member name="P:System.Net.FtpWebRequest.EnableSsl">
1499 <summary>Gets or sets a <see cref="T:System.Boolean"></see> that specifies that an SSL connection should be used.</summary>
1500 <returns><see langword="true"></see> if control and data transmissions are encrypted; otherwise, <see langword="false"></see>. The default value is <see langword="false"></see>.</returns>
1501 <exception cref="T:System.InvalidOperationException">The connection to the FTP server has already been established.</exception>
1503 <member name="M:System.Net.FtpWebRequest.EndGetRequestStream(System.IAsyncResult)">
1504 <summary>Ends a pending asynchronous operation started with <see cref="M:System.Net.FtpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see>.</summary>
1505 <param name="asyncResult">The <see cref="T:System.IAsyncResult"></see> object that was returned when the operation started.</param>
1506 <returns>A writable <see cref="T:System.IO.Stream"></see> instance associated with this instance.</returns>
1507 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is <see langword="null"></see>.</exception>
1508 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not obtained by calling <see cref="System.Net.FtpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see>.</exception>
1509 <exception cref="T:System.InvalidOperationException">This method was already called for the operation identified by <paramref name="asyncResult">asyncResult</paramref>.</exception>
1511 <member name="M:System.Net.FtpWebRequest.EndGetResponse(System.IAsyncResult)">
1512 <summary>Ends a pending asynchronous operation started with <see cref="M:System.Net.FtpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see>.</summary>
1513 <param name="asyncResult">The <see cref="T:System.IAsyncResult"></see> that was returned when the operation started.</param>
1514 <returns>A <see cref="T:System.Net.WebResponse"></see> reference that contains an <see cref="T:System.Net.FtpWebResponse"></see> instance. This object contains the FTP server&#39;s response to the request.</returns>
1515 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is <see langword="null"></see>.</exception>
1516 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not obtained by calling <see cref="System.Net.FtpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see>.</exception>
1517 <exception cref="T:System.InvalidOperationException">This method was already called for the operation identified by <paramref name="asyncResult">asyncResult</paramref>.</exception>
1518 <exception cref="T:System.Net.WebException">An error occurred using an HTTP proxy.</exception>
1520 <member name="M:System.Net.FtpWebRequest.GetRequestStream">
1521 <summary>Retrieves the stream used to upload data to an FTP server.</summary>
1522 <returns>A writable <see cref="T:System.IO.Stream"></see> instance used to store data to be sent to the server by the current request.</returns>
1523 <exception cref="T:System.InvalidOperationException"><see cref="System.Net.FtpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see> has been called and has not completed.
1525 An HTTP proxy is enabled, and you attempted to use an FTP command other than <see cref="System.Net.WebRequestMethods.Ftp.DownloadFile"></see>, <see cref="System.Net.WebRequestMethods.Ftp.ListDirectory"></see>, or <see cref="System.Net.WebRequestMethods.Ftp.ListDirectoryDetails"></see>.</exception>
1526 <exception cref="T:System.Net.WebException">A connection to the FTP server could not be established.</exception>
1527 <exception cref="T:System.Net.ProtocolViolationException">The <see cref="System.Net.FtpWebRequest.Method"></see> property is not set to <see cref="System.Net.WebRequestMethods.Ftp.UploadFile"></see> or <see cref="System.Net.WebRequestMethods.Ftp.AppendFile"></see>.</exception>
1529 <member name="M:System.Net.FtpWebRequest.GetResponse">
1530 <summary>Returns the FTP server response.</summary>
1531 <returns>A <see cref="T:System.Net.WebResponse"></see> reference that contains an <see cref="T:System.Net.FtpWebResponse"></see> instance. This object contains the FTP server&#39;s response to the request.</returns>
1532 <exception cref="T:System.InvalidOperationException"><see cref="System.Net.FtpWebRequest.GetResponse"></see> or <see cref="System.Net.FtpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see> has already been called for this instance.
1534 An HTTP proxy is enabled, and you attempted to use an FTP command other than <see cref="System.Net.WebRequestMethods.Ftp.DownloadFile"></see>, <see cref="System.Net.WebRequestMethods.Ftp.ListDirectory"></see>, or <see cref="System.Net.WebRequestMethods.Ftp.ListDirectoryDetails"></see>.</exception>
1535 <exception cref="T:System.Net.WebException"><see cref="System.Net.FtpWebRequest.EnableSsl"></see> is set to <see langword="true"></see>, but the server does not support this feature.
1537 A <see cref="System.Net.FtpWebRequest.Timeout"></see> was specified and the timeout has expired.</exception>
1539 <member name="P:System.Net.FtpWebRequest.Headers">
1540 <summary>Gets an empty <see cref="T:System.Net.WebHeaderCollection"></see> object.</summary>
1541 <returns>An empty <see cref="T:System.Net.WebHeaderCollection"></see> object.</returns>
1543 <member name="P:System.Net.FtpWebRequest.KeepAlive">
1544 <summary>Gets or sets a <see cref="T:System.Boolean"></see> value that specifies whether the control connection to the FTP server is closed after the request completes.</summary>
1545 <returns><see langword="true"></see> if the connection to the server should not be destroyed; otherwise, <see langword="false"></see>. The default value is <see langword="true"></see>.</returns>
1546 <exception cref="T:System.InvalidOperationException">A new value was specified for this property for a request that is already in progress.</exception>
1548 <member name="P:System.Net.FtpWebRequest.Method">
1549 <summary>Gets or sets the command to send to the FTP server.</summary>
1550 <returns>A <see cref="T:System.String"></see> value that contains the FTP command to send to the server. The default value is <see cref="F:System.Net.WebRequestMethods.Ftp.DownloadFile"></see>.</returns>
1551 <exception cref="T:System.InvalidOperationException">A new value was specified for this property for a request that is already in progress.</exception>
1552 <exception cref="T:System.ArgumentException">The method is invalid.
1554 The method is not supported.
1556 Multiple methods were specified.</exception>
1558 <member name="P:System.Net.FtpWebRequest.PreAuthenticate">
1559 <summary>Always throws a <see cref="T:System.NotSupportedException"></see>.</summary>
1560 <returns>Always throws a <see cref="T:System.NotSupportedException"></see>.</returns>
1561 <exception cref="T:System.NotSupportedException">Preauthentication is not supported for FTP.</exception>
1563 <member name="P:System.Net.FtpWebRequest.Proxy">
1564 <summary>Gets or sets the proxy used to communicate with the FTP server.</summary>
1565 <returns>An <see cref="T:System.Net.IWebProxy"></see> instance responsible for communicating with the FTP server.</returns>
1566 <exception cref="T:System.ArgumentNullException">This property cannot be set to <see langword="null"></see>.</exception>
1567 <exception cref="T:System.InvalidOperationException">A new value was specified for this property for a request that is already in progress.</exception>
1569 <member name="P:System.Net.FtpWebRequest.ReadWriteTimeout">
1570 <summary>Gets or sets a time-out when reading from or writing to a stream.</summary>
1571 <returns>The number of milliseconds before the reading or writing times out. The default value is 300,000 milliseconds (5 minutes).</returns>
1572 <exception cref="T:System.InvalidOperationException">The request has already been sent.</exception>
1573 <exception cref="T:System.ArgumentOutOfRangeException">The value specified for a set operation is less than or equal to zero and is not equal to <see cref="System.Threading.Timeout.Infinite"></see>.</exception>
1575 <member name="P:System.Net.FtpWebRequest.RenameTo">
1576 <summary>Gets or sets the new name of a file being renamed.</summary>
1577 <returns>The new name of the file being renamed.</returns>
1578 <exception cref="T:System.ArgumentException">The value specified for a set operation is <see langword="null"></see> or an empty string.</exception>
1579 <exception cref="T:System.InvalidOperationException">A new value was specified for this property for a request that is already in progress.</exception>
1581 <member name="P:System.Net.FtpWebRequest.RequestUri">
1582 <summary>Gets the URI requested by this instance.</summary>
1583 <returns>A <see cref="T:System.Uri"></see> instance that identifies a resource that is accessed using the File Transfer Protocol.</returns>
1585 <member name="P:System.Net.FtpWebRequest.ServicePoint">
1586 <summary>Gets the <see cref="T:System.Net.ServicePoint"></see> object used to connect to the FTP server.</summary>
1587 <returns>A <see cref="T:System.Net.ServicePoint"></see> object that can be used to customize connection behavior.</returns>
1589 <member name="P:System.Net.FtpWebRequest.Timeout">
1590 <summary>Gets or sets the number of milliseconds to wait for a request.</summary>
1591 <returns>An <see cref="T:System.Int32"></see> value that contains the number of milliseconds to wait before a request times out. The default value is <see cref="F:System.Threading.Timeout.Infinite"></see>.</returns>
1592 <exception cref="T:System.ArgumentOutOfRangeException">The value specified is less than zero and is not <see cref="System.Threading.Timeout.Infinite"></see>.</exception>
1593 <exception cref="T:System.InvalidOperationException">A new value was specified for this property for a request that is already in progress.</exception>
1595 <member name="P:System.Net.FtpWebRequest.UseBinary">
1596 <summary>Gets or sets a <see cref="T:System.Boolean"></see> value that specifies the data type for file transfers.</summary>
1597 <returns><see langword="true"></see> to indicate to the server that the data to be transferred is binary; <see langword="false"></see> to indicate that the data is text. The default value is <see langword="true"></see>.</returns>
1598 <exception cref="T:System.InvalidOperationException">A new value was specified for this property for a request that is already in progress.</exception>
1600 <member name="P:System.Net.FtpWebRequest.UseDefaultCredentials">
1601 <summary>Always throws a <see cref="T:System.NotSupportedException"></see>.</summary>
1602 <returns>Always throws a <see cref="T:System.NotSupportedException"></see>.</returns>
1603 <exception cref="T:System.NotSupportedException">Default credentials are not supported for FTP.</exception>
1605 <member name="P:System.Net.FtpWebRequest.UsePassive">
1606 <summary>Gets or sets the behavior of a client application&#39;s data transfer process.</summary>
1607 <returns><see langword="false"></see> if the client application&#39;s data transfer process listens for a connection on the data port; otherwise, <see langword="true"></see> if the client should initiate a connection on the data port. The default value is <see langword="true"></see>.</returns>
1608 <exception cref="T:System.InvalidOperationException">A new value was specified for this property for a request that is already in progress.</exception>
1610 <member name="T:System.Net.FtpStatusCode">
1611 <summary>Specifies the status codes returned for a File Transfer Protocol (FTP) operation.</summary>
1613 <member name="F:System.Net.FtpStatusCode.AccountNeeded">
1614 <summary>Specifies that a user account on the server is required.</summary>
1617 <member name="F:System.Net.FtpStatusCode.ActionAbortedLocalProcessingError">
1618 <summary>Specifies that an error occurred that prevented the request action from completing.</summary>
1621 <member name="F:System.Net.FtpStatusCode.ActionAbortedUnknownPageType">
1622 <summary>Specifies that the requested action cannot be taken because the specified page type is unknown. Page types are described in RFC 959 Section 3.1.2.3</summary>
1625 <member name="F:System.Net.FtpStatusCode.ActionNotTakenFilenameNotAllowed">
1626 <summary>Specifies that the requested action cannot be performed on the specified file.</summary>
1629 <member name="F:System.Net.FtpStatusCode.ActionNotTakenFileUnavailable">
1630 <summary>Specifies that the requested action cannot be performed on the specified file because the file is not available.</summary>
1633 <member name="F:System.Net.FtpStatusCode.ActionNotTakenFileUnavailableOrBusy">
1634 <summary>Specifies that the requested action cannot be performed on the specified file because the file is not available or is being used.</summary>
1637 <member name="F:System.Net.FtpStatusCode.ActionNotTakenInsufficientSpace">
1638 <summary>Specifies that the requested action cannot be performed because there is not enough space on the server.</summary>
1641 <member name="F:System.Net.FtpStatusCode.ArgumentSyntaxError">
1642 <summary>Specifies that one or more command arguments has a syntax error.</summary>
1645 <member name="F:System.Net.FtpStatusCode.BadCommandSequence">
1646 <summary>Specifies that the sequence of commands is not in the correct order.</summary>
1649 <member name="F:System.Net.FtpStatusCode.CantOpenData">
1650 <summary>Specifies that the data connection cannot be opened.</summary>
1653 <member name="F:System.Net.FtpStatusCode.ClosingControl">
1654 <summary>Specifies that the server is closing the control connection.</summary>
1657 <member name="F:System.Net.FtpStatusCode.ClosingData">
1658 <summary>Specifies that the server is closing the data connection and that the requested file action was successful.</summary>
1661 <member name="F:System.Net.FtpStatusCode.CommandExtraneous">
1662 <summary>Specifies that the command is not implemented by the server because it is not needed.</summary>
1665 <member name="F:System.Net.FtpStatusCode.CommandNotImplemented">
1666 <summary>Specifies that the command is not implemented by the FTP server.</summary>
1669 <member name="F:System.Net.FtpStatusCode.CommandOK">
1670 <summary>Specifies that the command completed successfully.</summary>
1673 <member name="F:System.Net.FtpStatusCode.CommandSyntaxError">
1674 <summary>Specifies that the command has a syntax error or is not a command recognized by the server.</summary>
1677 <member name="F:System.Net.FtpStatusCode.ConnectionClosed">
1678 <summary>Specifies that the connection has been closed.</summary>
1681 <member name="F:System.Net.FtpStatusCode.DataAlreadyOpen">
1682 <summary>Specifies that the data connection is already open and the requested transfer is starting.</summary>
1685 <member name="F:System.Net.FtpStatusCode.DirectoryStatus">
1686 <summary>Specifies the status of a directory.</summary>
1689 <member name="F:System.Net.FtpStatusCode.EnteringPassive">
1690 <summary>Specifies that the server is entering passive mode.</summary>
1693 <member name="F:System.Net.FtpStatusCode.FileActionAborted">
1694 <summary>Specifies that the requested action cannot be performed.</summary>
1697 <member name="F:System.Net.FtpStatusCode.FileActionOK">
1698 <summary>Specifies that the requested file action completed successfully.</summary>
1701 <member name="F:System.Net.FtpStatusCode.FileCommandPending">
1702 <summary>Specifies that the requested file action requires additional information.</summary>
1705 <member name="F:System.Net.FtpStatusCode.FileStatus">
1706 <summary>Specifies the status of a file.</summary>
1709 <member name="F:System.Net.FtpStatusCode.LoggedInProceed">
1710 <summary>Specifies that the user is logged in and can send commands.</summary>
1713 <member name="F:System.Net.FtpStatusCode.NeedLoginAccount">
1714 <summary>Specifies that the server requires a login account to be supplied.</summary>
1717 <member name="F:System.Net.FtpStatusCode.NotLoggedIn">
1718 <summary>Specifies that login information must be sent to the server.</summary>
1721 <member name="F:System.Net.FtpStatusCode.OpeningData">
1722 <summary>Specifies that the server is opening the data connection.</summary>
1725 <member name="F:System.Net.FtpStatusCode.PathnameCreated">
1726 <summary>Specifies that the requested path name was created.</summary>
1729 <member name="F:System.Net.FtpStatusCode.RestartMarker">
1730 <summary>Specifies that the response contains a restart marker reply. The text of the description that accompanies this status contains the user data stream marker and the server marker.</summary>
1733 <member name="F:System.Net.FtpStatusCode.SendPasswordCommand">
1734 <summary>Specifies that the server expects a password to be supplied.</summary>
1737 <member name="F:System.Net.FtpStatusCode.SendUserCommand">
1738 <summary>Specifies that the server is ready for a user login operation.</summary>
1741 <member name="F:System.Net.FtpStatusCode.ServerWantsSecureSession">
1742 <summary>Specifies that the server accepts the authentication mechanism specified by the client, and the exchange of security data is complete.</summary>
1745 <member name="F:System.Net.FtpStatusCode.ServiceNotAvailable">
1746 <summary>Specifies that the service is not available.</summary>
1749 <member name="F:System.Net.FtpStatusCode.ServiceTemporarilyNotAvailable">
1750 <summary>Specifies that the service is not available now; try your request later.</summary>
1753 <member name="F:System.Net.FtpStatusCode.SystemType">
1754 <summary>Specifies the system type name using the system names published in the Assigned Numbers document published by the Internet Assigned Numbers Authority.</summary>
1757 <member name="F:System.Net.FtpStatusCode.Undefined">
1758 <summary>Included for completeness, this value is never returned by servers.</summary>
1761 <member name="T:System.Net.FileWebResponse">
1762 <summary>Provides a file system implementation of the <see cref="T:System.Net.WebResponse"></see> class.</summary>
1764 <member name="M:System.Net.FileWebResponse.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
1765 <summary>Initializes a new instance of the <see cref="T:System.Net.FileWebResponse"></see> class from the specified instances of the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> classes.</summary>
1766 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> instance that contains the information required to serialize the new <see cref="T:System.Net.FileWebResponse"></see> instance.</param>
1767 <param name="streamingContext">An instance of the <see cref="T:System.Runtime.Serialization.StreamingContext"></see> class that contains the source of the serialized stream associated with the new <see cref="T:System.Net.FileWebResponse"></see> instance.</param>
1769 <member name="M:System.Net.FileWebResponse.Close">
1770 <summary>Closes the response stream.</summary>
1772 <member name="P:System.Net.FileWebResponse.ContentLength">
1773 <summary>Gets the length of the content in the file system resource.</summary>
1774 <returns>The number of bytes returned from the file system resource.</returns>
1776 <member name="P:System.Net.FileWebResponse.ContentType">
1777 <summary>Gets the content type of the file system resource.</summary>
1778 <returns>The value &quot;binary/octet-stream&quot;.</returns>
1780 <member name="M:System.Net.FileWebResponse.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
1781 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> with the data needed to serialize the target object.</summary>
1782 <param name="serializationInfo">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to populate with data.</param>
1783 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that specifies the destination for this serialization.</param>
1785 <member name="M:System.Net.FileWebResponse.GetResponseStream">
1786 <summary>Returns the data stream from the file system resource.</summary>
1787 <returns>A <see cref="T:System.IO.Stream"></see> for reading data from the file system resource.</returns>
1789 <member name="P:System.Net.FileWebResponse.Headers">
1790 <summary>Gets a collection of header name/value pairs associated with the response.</summary>
1791 <returns>A <see cref="T:System.Net.WebHeaderCollection"></see> that contains the header name/value pairs associated with the response.</returns>
1793 <member name="P:System.Net.FileWebResponse.ResponseUri">
1794 <summary>Gets the URI of the file system resource that provided the response.</summary>
1795 <returns>A <see cref="T:System.Uri"></see> that contains the URI of the file system resource that provided the response.</returns>
1797 <member name="P:System.Net.FileWebResponse.SupportsHeaders">
1798 <summary>Gets a value that indicates whether the <see cref="P:System.Net.FileWebResponse.Headers"></see> property is supported by the <see cref="T:System.Net.FileWebResponse"></see> instance.</summary>
1799 <returns>Returns <see cref="T:System.Boolean"></see>.
1800 true if the <see cref="P:System.Net.FileWebResponse.Headers"></see> property is supported by the <see cref="T:System.Net.FileWebResponse"></see> instance; otherwise, false.</returns>
1802 <member name="M:System.Net.FileWebResponse.System#Runtime#Serialization#ISerializable#GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
1803 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> instance with the data needed to serialize the <see cref="T:System.Net.FileWebResponse"></see>.</summary>
1804 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> , which will hold the serialized data for the <see cref="T:System.Net.FileWebResponse"></see>.</param>
1805 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> containing the destination of the serialized stream associated with the new <see cref="T:System.Net.FileWebResponse"></see>.</param>
1807 <member name="T:System.Net.FileWebRequest">
1808 <summary>Provides a file system implementation of the <see cref="T:System.Net.WebRequest"></see> class.</summary>
1810 <member name="M:System.Net.FileWebRequest.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
1811 <summary>Initializes a new instance of the <see cref="T:System.Net.FileWebRequest"></see> class from the specified instances of the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> classes.</summary>
1812 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object that contains the information that is required to serialize the new <see cref="T:System.Net.FileWebRequest"></see> object.</param>
1813 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> object that contains the source of the serialized stream that is associated with the new <see cref="T:System.Net.FileWebRequest"></see> object.</param>
1815 <member name="M:System.Net.FileWebRequest.Abort">
1816 <summary>Cancels a request to an Internet resource.</summary>
1818 <member name="M:System.Net.FileWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)">
1819 <summary>Begins an asynchronous request for a <see cref="T:System.IO.Stream"></see> object to use to write data.</summary>
1820 <param name="callback">The <see cref="T:System.AsyncCallback"></see> delegate.</param>
1821 <param name="state">An object that contains state information for this request.</param>
1822 <returns>An <see cref="T:System.IAsyncResult"></see> that references the asynchronous request.</returns>
1823 <exception cref="T:System.Net.ProtocolViolationException">The <see cref="System.Net.FileWebRequest.Method"></see> property is GET and the application writes to the stream.</exception>
1824 <exception cref="T:System.InvalidOperationException">The stream is being used by a previous call to <see cref="System.Net.FileWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)"></see>.</exception>
1825 <exception cref="T:System.ApplicationException">No write stream is available.</exception>
1826 <exception cref="T:System.Net.WebException">The <see cref="System.Net.FileWebRequest"></see> was aborted.</exception>
1828 <member name="M:System.Net.FileWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)">
1829 <summary>Begins an asynchronous request for a file system resource.</summary>
1830 <param name="callback">The <see cref="T:System.AsyncCallback"></see> delegate.</param>
1831 <param name="state">An object that contains state information for this request.</param>
1832 <returns>An <see cref="T:System.IAsyncResult"></see> that references the asynchronous request.</returns>
1833 <exception cref="T:System.InvalidOperationException">The stream is already in use by a previous call to <see cref="System.Net.FileWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)"></see>.</exception>
1834 <exception cref="T:System.Net.WebException">The <see cref="System.Net.FileWebRequest"></see> was aborted.</exception>
1836 <member name="P:System.Net.FileWebRequest.ConnectionGroupName">
1837 <summary>Gets or sets the name of the connection group for the request. This property is reserved for future use.</summary>
1838 <returns>The name of the connection group for the request.</returns>
1840 <member name="P:System.Net.FileWebRequest.ContentLength">
1841 <summary>Gets or sets the content length of the data being sent.</summary>
1842 <returns>The number of bytes of request data being sent.</returns>
1843 <exception cref="T:System.ArgumentException"><see cref="System.Net.FileWebRequest.ContentLength"></see> is less than 0.</exception>
1845 <member name="P:System.Net.FileWebRequest.ContentType">
1846 <summary>Gets or sets the content type of the data being sent. This property is reserved for future use.</summary>
1847 <returns>The content type of the data being sent.</returns>
1849 <member name="P:System.Net.FileWebRequest.Credentials">
1850 <summary>Gets or sets the credentials that are associated with this request. This property is reserved for future use.</summary>
1851 <returns>An <see cref="T:System.Net.ICredentials"></see> that contains the authentication credentials that are associated with this request. The default is <see langword="null"></see>.</returns>
1853 <member name="M:System.Net.FileWebRequest.EndGetRequestStream(System.IAsyncResult)">
1854 <summary>Ends an asynchronous request for a <see cref="T:System.IO.Stream"></see> instance that the application uses to write data.</summary>
1855 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> that references the pending request for a stream.</param>
1856 <returns>A <see cref="T:System.IO.Stream"></see> object that the application uses to write data.</returns>
1857 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is <see langword="null"></see>.</exception>
1859 <member name="M:System.Net.FileWebRequest.EndGetResponse(System.IAsyncResult)">
1860 <summary>Ends an asynchronous request for a file system resource.</summary>
1861 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> that references the pending request for a response.</param>
1862 <returns>A <see cref="T:System.Net.WebResponse"></see> that contains the response from the file system resource.</returns>
1863 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is <see langword="null"></see>.</exception>
1865 <member name="M:System.Net.FileWebRequest.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
1866 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> with the data needed to serialize the target object.</summary>
1867 <param name="serializationInfo">The <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> to populate with data.</param>
1868 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that specifies the destination for this serialization.</param>
1870 <member name="M:System.Net.FileWebRequest.GetRequestStream">
1871 <summary>Returns a <see cref="T:System.IO.Stream"></see> object for writing data to the file system resource.</summary>
1872 <returns>A <see cref="T:System.IO.Stream"></see> for writing data to the file system resource.</returns>
1873 <exception cref="T:System.Net.WebException">The request times out.</exception>
1875 <member name="M:System.Net.FileWebRequest.GetResponse">
1876 <summary>Returns a response to a file system request.</summary>
1877 <returns>A <see cref="T:System.Net.WebResponse"></see> that contains the response from the file system resource.</returns>
1878 <exception cref="T:System.Net.WebException">The request timed out.</exception>
1880 <member name="P:System.Net.FileWebRequest.Headers">
1881 <summary>Gets a collection of the name/value pairs that are associated with the request. This property is reserved for future use.</summary>
1882 <returns>A <see cref="T:System.Net.WebHeaderCollection"></see> that contains header name/value pairs associated with this request.</returns>
1884 <member name="P:System.Net.FileWebRequest.Method">
1885 <summary>Gets or sets the protocol method used for the request. This property is reserved for future use.</summary>
1886 <returns>The protocol method to use in this request.</returns>
1887 <exception cref="T:System.ArgumentException">The method is invalid.
1889 The method is not supported.
1891 Multiple methods were specified.</exception>
1893 <member name="P:System.Net.FileWebRequest.PreAuthenticate">
1894 <summary>Gets or sets a value that indicates whether to preauthenticate a request. This property is reserved for future use.</summary>
1895 <returns><see langword="true"></see> to preauthenticate; otherwise, <see langword="false"></see>.</returns>
1897 <member name="P:System.Net.FileWebRequest.Proxy">
1898 <summary>Gets or sets the network proxy to use for this request. This property is reserved for future use.</summary>
1899 <returns>An <see cref="T:System.Net.IWebProxy"></see> that indicates the network proxy to use for this request.</returns>
1901 <member name="P:System.Net.FileWebRequest.RequestUri">
1902 <summary>Gets the Uniform Resource Identifier (URI) of the request.</summary>
1903 <returns>A <see cref="T:System.Uri"></see> that contains the URI of the request.</returns>
1905 <member name="P:System.Net.FileWebRequest.Timeout">
1906 <summary>Gets or sets the length of time until the request times out.</summary>
1907 <returns>The time, in milliseconds, until the request times out, or the value <see cref="F:System.Threading.Timeout.Infinite"></see> to indicate that the request does not time out.</returns>
1908 <exception cref="T:System.ArgumentOutOfRangeException">The value specified is less than or equal to zero and is not <see cref="System.Threading.Timeout.Infinite"></see>.</exception>
1910 <member name="P:System.Net.FileWebRequest.UseDefaultCredentials">
1911 <summary>Always throws a <see cref="T:System.NotSupportedException"></see>.</summary>
1912 <returns>Always throws a <see cref="T:System.NotSupportedException"></see>.</returns>
1913 <exception cref="T:System.NotSupportedException">Default credentials are not supported for file Uniform Resource Identifiers (URIs).</exception>
1915 <member name="M:System.Net.FileWebRequest.System#Runtime#Serialization#ISerializable#GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
1916 <summary>Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object with the required data to serialize the <see cref="T:System.Net.FileWebRequest"></see>.</summary>
1917 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> that holds the serialized data for the <see cref="T:System.Net.FileWebRequest"></see>.</param>
1918 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> that contains the destination of the serialized stream that is associated with the new <see cref="T:System.Net.FileWebRequest"></see>.</param>