System.Net.Requests

Manages the authentication modules called during the client authentication process.

Calls each registered authentication module to find the first module that can respond to the authentication request.

The challenge returned by the Internet resource. The that initiated the authentication challenge. The associated with this request. An instance of the class containing the result of the authorization attempt. If there is no authentication module to respond to the challenge, this method returns null. challenge is null. -or- request is null. -or- credentials is null.

Gets or sets the credential policy to be used for resource requests made using the class.

An object that implements the interface that determines whether credentials are sent with requests. The default value is null.

Gets the dictionary that contains Service Principal Names (SPNs) that are used to identify hosts during Kerberos authentication for requests made using and its derived classes.

A writable that contains the SPN values for keys composed of host information.

Preauthenticates a request.

A to an Internet resource. The associated with the request. An instance of the class if the request can be preauthenticated; otherwise, null. If credentials is null, this method returns null. request is null.

Registers an authentication module with the authentication manager.

The to register with the authentication manager. authenticationModule is null.

Gets a list of authentication modules that are registered with the authentication manager.

An that enables the registered authentication modules to be read.

Removes the specified authentication module from the list of registered modules.

The to remove from the list of registered modules. authenticationModule is null. The specified is not registered.

Removes authentication modules with the specified authentication scheme from the list of registered modules.

The authentication scheme of the module to remove. authenticationScheme is null. A module for this authentication scheme is not registered.

Contains an authentication message for an Internet server.

Creates a new instance of the class with the specified authorization message.

The encrypted authorization message expected by the server.

Creates a new instance of the class with the specified authorization message and completion status.

The encrypted authorization message expected by the server. The completion status of the authorization attempt. true if the authorization attempt is complete; otherwise, false.

Creates a new instance of the class with the specified authorization message, completion status, and connection group identifier.

The encrypted authorization message expected by the server. The completion status of the authorization attempt. true if the authorization attempt is complete; otherwise, false. A unique identifier that can be used to create private client-server connections that are bound only to this authentication scheme.

Gets the completion status of the authorization.

true if the authentication process is complete; otherwise, false.

Gets a unique identifier for user-specific connections.

A unique string that associates a connection with an authenticating entity.

Gets the message returned to the server in response to an authentication challenge.

The message that will be returned to the server in response to an authentication challenge.

Gets or sets a value that indicates whether mutual authentication occurred.

true if both client and server were authenticated; otherwise, false.

Gets or sets the prefix for Uniform Resource Identifiers (URIs) that can be authenticated with the property.

An array of strings that contains URI prefixes.

Provides a file system implementation of the class.

Initializes a new instance of the class from the specified instances of the and classes.

A instance that contains the information required to serialize the new instance. An instance of the class that contains the source of the serialized stream associated with the new instance.

Closes the response stream.

Gets the length of the content in the file system resource.

The number of bytes returned from the file system resource.

Gets the content type of the file system resource.

The value "binary/octet-stream".

Populates a with the data needed to serialize the target object.

The to populate with data. A that specifies the destination for this serialization.

Returns the data stream from the file system resource.

A for reading data from the file system resource.

Gets a collection of header name/value pairs associated with the response.

A that contains the header name/value pairs associated with the response.

Gets the URI of the file system resource that provided the response.

A that contains the URI of the file system resource that provided the response.

Gets a value that indicates whether the property is supported by the instance.

Returns . true if the property is supported by the instance; otherwise, false.

Populates a instance with the data needed to serialize the .

A , which will hold the serialized data for the . A containing the destination of the serialized stream associated with the new .

Specifies the status codes returned for a File Transfer Protocol (FTP) operation.

Specifies that a user account on the server is required.

Specifies that an error occurred that prevented the request action from completing.

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

Specifies that the requested action cannot be performed on the specified file.

Specifies that the requested action cannot be performed on the specified file because the file is not available.

Specifies that the requested action cannot be performed on the specified file because the file is not available or is being used.

Specifies that the requested action cannot be performed because there is not enough space on the server.

Specifies that one or more command arguments has a syntax error.

Specifies that the sequence of commands is not in the correct order.

Specifies that the data connection cannot be opened.

Specifies that the server is closing the control connection.

Specifies that the server is closing the data connection and that the requested file action was successful.

Specifies that the command is not implemented by the server because it is not needed.

Specifies that the command is not implemented by the FTP server.

Specifies that the command completed successfully.

Specifies that the command has a syntax error or is not a command recognized by the server.

Specifies that the connection has been closed.

Specifies that the data connection is already open and the requested transfer is starting.

Specifies the status of a directory.

Specifies that the server is entering passive mode.

Specifies that the requested action cannot be performed.

Specifies that the requested file action completed successfully.

Specifies that the requested file action requires additional information.

Specifies the status of a file.

Specifies that the user is logged in and can send commands.

Specifies that the server requires a login account to be supplied.

Specifies that login information must be sent to the server.

Specifies that the server is opening the data connection.

Specifies that the requested path name was created.

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.

Specifies that the server expects a password to be supplied.

Specifies that the server is ready for a user login operation.

Specifies that the server accepts the authentication mechanism specified by the client, and the exchange of security data is complete.

Specifies that the service is not available.

Specifies that the service is not available now; try your request later.

Specifies the system type name using the system names published in the Assigned Numbers document published by the Internet Assigned Numbers Authority.

Included for completeness, this value is never returned by servers.

Implements a File Transfer Protocol (FTP) client.

Terminates an asynchronous FTP operation.

Begins asynchronously opening a request's content stream for writing.

An delegate that references the method to invoke when the operation is complete. A user-defined object that contains information about the operation. This object is passed to the callback delegate when the operation completes. An instance that indicates the status of the operation. A previous call to this method or has not yet completed. A connection to the FTP server could not be established. The property is not set to .

Begins sending a request and receiving a response from an FTP server asynchronously.

An delegate that references the method to invoke when the operation is complete. A user-defined object that contains information about the operation. This object is passed to the callback delegate when the operation completes. An instance that indicates the status of the operation. or has already been called for this instance.

Gets or sets the certificates used for establishing an encrypted connection to the FTP server.

An object that contains the client certificates. The value specified for a set operation is null.

Gets or sets the name of the connection group that contains the service point used to send the current request.

A value that contains a connection group name. A new value was specified for this property for a request that is already in progress.

Gets or sets a value that is ignored by the class.

An value that should be ignored.

Gets or sets a byte offset into the file being downloaded by this request.

An instance that specifies the file offset, in bytes. The default value is zero. A new value was specified for this property for a request that is already in progress. The value specified for this property is less than zero.

Always throws a .

Always throws a . Content type information is not supported for FTP.

Gets or sets the credentials used to communicate with the FTP server.

An instance; otherwise, null if the property has not been set. The value specified for a set operation is null. An of a type other than was specified for a set operation. A new value was specified for this property for a request that is already in progress.

Defines the default cache policy for all FTP requests.

A that defines the cache policy for FTP requests. The caller tried to set this property to null.

Gets or sets a that specifies that an SSL connection should be used.

true if control and data transmissions are encrypted; otherwise, false. The default value is false. The connection to the FTP server has already been established.

Ends a pending asynchronous operation started with .

The object that was returned when the operation started. A writable instance associated with this instance. asyncResult is null. asyncResult was not obtained by calling . This method was already called for the operation identified by asyncResult.

Ends a pending asynchronous operation started with .

The that was returned when the operation started. A reference that contains an instance. This object contains the FTP server's response to the request. asyncResult is null. asyncResult was not obtained by calling . This method was already called for the operation identified by asyncResult. An error occurred using an HTTP proxy.

Retrieves the stream used to upload data to an FTP server.

A writable instance used to store data to be sent to the server by the current request. has been called and has not completed. - or - An HTTP proxy is enabled, and you attempted to use an FTP command other than , , or . A connection to the FTP server could not be established. The property is not set to or .

Returns the FTP server response.

A reference that contains an instance. This object contains the FTP server's response to the request. or has already been called for this instance. - or - An HTTP proxy is enabled, and you attempted to use an FTP command other than , , or . is set to true, but the server does not support this feature. - or - A was specified and the timeout has expired.

Gets an empty object.

An empty object.

Gets or sets a value that specifies whether the control connection to the FTP server is closed after the request completes.

true if the connection to the server should not be destroyed; otherwise, false. The default value is true. A new value was specified for this property for a request that is already in progress.

Gets or sets the command to send to the FTP server.

A value that contains the FTP command to send to the server. The default value is . A new value was specified for this property for a request that is already in progress. The method is invalid. - or - The method is not supported. - or - Multiple methods were specified.

Always throws a .

Always throws a . Preauthentication is not supported for FTP.

Gets or sets the proxy used to communicate with the FTP server.

An instance responsible for communicating with the FTP server. This property cannot be set to null. A new value was specified for this property for a request that is already in progress.

Gets or sets a time-out when reading from or writing to a stream.

The number of milliseconds before the reading or writing times out. The default value is 300,000 milliseconds (5 minutes). The request has already been sent. The value specified for a set operation is less than or equal to zero and is not equal to .

Gets or sets the new name of a file being renamed.

The new name of the file being renamed. The value specified for a set operation is null or an empty string. A new value was specified for this property for a request that is already in progress.

Gets the URI requested by this instance.

A instance that identifies a resource that is accessed using the File Transfer Protocol.

Gets the object used to connect to the FTP server.

A object that can be used to customize connection behavior.

Gets or sets the number of milliseconds to wait for a request.

An value that contains the number of milliseconds to wait before a request times out. The default value is . The value specified is less than zero and is not . A new value was specified for this property for a request that is already in progress.

Gets or sets a value that specifies the data type for file transfers.

true to indicate to the server that the data to be transferred is binary; false to indicate that the data is text. The default value is true. A new value was specified for this property for a request that is already in progress.

Always throws a .

Always throws a . Default credentials are not supported for FTP.

Gets or sets the behavior of a client application's data transfer process.

false if the client application's data transfer process listens for a connection on the data port; otherwise, true if the client should initiate a connection on the data port. The default value is true. A new value was specified for this property for a request that is already in progress.

Encapsulates a File Transfer Protocol (FTP) server's response to a request.

Gets the message sent by the FTP server when a connection is established prior to logon.

A that contains the banner message sent by the server; otherwise, if no message is sent.

Frees the resources held by the response.

Gets the length of the data received from the FTP server.

An value that contains the number of bytes of data received from the FTP server.

Gets the message sent by the server when the FTP session is ending.

A that contains the exit message sent by the server; otherwise, if no message is sent.

Retrieves the stream that contains response data sent from an FTP server.

A readable instance that contains data returned with the response; otherwise, if no response data was returned by the server. The response did not return a data stream.

Gets an empty object.

An empty object.

Gets the date and time that a file on an FTP server was last modified.

A that contains the last modified date and time for a file.

Gets the URI that sent the response to the request.

A instance that identifies the resource associated with this response.

Gets the most recent status code sent from the FTP server.

An value that indicates the most recent status code returned with this response.

Gets text that describes a status code sent from the FTP server.

A instance that contains the status code and message returned with this response.

Gets a value that indicates whether the property is supported by the instance.

Returns . true if the property is supported by the instance; otherwise, false.

Gets the message sent by the FTP server when authentication is complete.

A that contains the welcome message sent by the server; otherwise, if no message is sent.

Contains a global default proxy instance for all HTTP requests.

Initializes a new instance of the class.

Returns an empty proxy instance.

An that contains no information.

Gets or sets the global HTTP proxy.

An that every call to uses. The value specified for a set operation was null. The caller does not have permission for the requested operation.

Represents the method that notifies callers when a continue response is received by the client.

The numeric value of the HTTP status from the server. The headers returned with the 100-continue response from the server.

Provides the base authentication interface for Web client authentication modules.

Returns an instance of the class in respose to an authentication challenge from a server.

The authentication challenge sent by the server. The instance associated with the challenge. The credentials associated with the challenge. An instance containing the authorization message for the request, or null if the challenge cannot be handled.

Gets the authentication type provided by this authentication module.

A string indicating the authentication type provided by this authentication module.

Gets a value indicating whether the authentication module supports preauthentication.

true if the authorization module supports preauthentication; otherwise false.

Returns an instance of the class for an authentication request to a server.

The instance associated with the authentication request. The credentials associated with the authentication request. An instance containing the authorization message for the request.

Defines the credential policy to be used for resource requests that are made using and its derived classes.

Returns a that indicates whether the client's credentials are sent with a resource request made using an instance of the class.

The that will receive the request. The that represents the resource being requested. The that will be sent with the request if this method returns true. The that will conduct the authentication, if authentication is required. true if the credentials are sent with the request; otherwise, false.

Provides the base interface for creating instances.

Creates a instance.

The uniform resource identifier (URI) of the Web resource. A instance. The request scheme specified in uri is not supported by this instance. uri is null. 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, , instead. The URI specified in uri is not a valid URI.

The exception that is thrown when an error occurs while accessing the network through a pluggable protocol.

Initializes a new instance of the class.

Initializes a new instance of the class with the specified error message.

The text of the error message.

Initializes a new instance of the class from the specified and instances.

A that contains the information required to serialize the new . A that contains the source of the serialized stream that is associated with the new .

Initializes a new instance of the class with the specified error message and nested exception.

The text of the error message. A nested exception.

Initializes a new instance of the class with the specified error message and status.

The text of the error message. One of the values.

Initializes a new instance of the class with the specified error message, nested exception, status, and response.

The text of the error message. A nested exception. One of the values. A instance that contains the response from the remote host.

Populates a instance with the data needed to serialize the .

The to be used. The to be used.

Gets the response that the remote host returned.

If a response is available from the Internet resource, a instance that contains the error response from an Internet resource; otherwise, null.

Gets the status of the response.

One of the values.

Serializes this instance into the specified object.

The object into which this will be serialized. The destination of the serialization.

Defines status codes for the class.

The specified cache entry was not found.

The remote service point could not be contacted at the transport level.

The connection was prematurely closed.

The connection for a request that specifies the Keep-alive header was closed unexpectedly.

A message was received that exceeded the specified limit when sending a request or receiving a response from the server.

The name resolver service could not resolve the host name.

An internal asynchronous request is pending.

The request was a pipelined request and the connection was closed before the response was received.

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.

The name resolver service could not resolve the proxy host name.

A complete response was not received from the remote server.

The request was canceled, the method was called, or an unclassifiable error occurred. This is the default value for .

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.

This request was not permitted by the proxy.

An error occurred while establishing a connection using SSL.

A complete request could not be sent to the remote server.

The server response was not a valid HTTP response.

No error was encountered.

No response was received during the time-out period for a request.

A server certificate could not be validated.

An exception of unknown type has occurred.

Represents the types of file protocol methods that can be used with a FILE request. This class cannot be inherited.

Represents the FILE GET protocol method that is used to retrieve a file from a specified location.

Represents the FILE PUT protocol method that is used to copy a file to a specified location.

Represents the types of FTP protocol methods that can be used with an FTP request. This class cannot be inherited.

Represents the FTP APPE protocol method that is used to append a file to an existing file on an FTP server.

Represents the FTP DELE protocol method that is used to delete a file on an FTP server.

Represents the FTP RETR protocol method that is used to download a file from an FTP server.

Represents the FTP MDTM protocol method that is used to retrieve the date-time stamp from a file on an FTP server.

Represents the FTP SIZE protocol method that is used to retrieve the size of a file on an FTP server.

Represents the FTP NLIST protocol method that gets a short listing of the files on an FTP server.

Represents the FTP LIST protocol method that gets a detailed listing of the files on an FTP server.

Represents the FTP MKD protocol method creates a directory on an FTP server.

Represents the FTP PWD protocol method that prints the name of the current working directory.

Represents the FTP RMD protocol method that removes a directory.

Represents the FTP RENAME protocol method that renames a directory.

Represents the FTP STOR protocol method that uploads a file to an FTP server.

Represents the FTP STOU protocol that uploads a file with a unique name to an FTP server.

Represents the types of HTTP protocol methods that can be used with an HTTP request.

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.

Represents an HTTP GET protocol method.

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.

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).

Represents an HTTP POST protocol method that is used to post a new entity as an addition to a URI.

Represents an HTTP PUT protocol method that is used to replace an entity identified by a URI.

Container class for , , and classes. This class cannot be inherited

Provides a response from a Uniform Resource Identifier (URI). This is an abstract class.

Initializes a new instance of the class.

Initializes a new instance of the class from the specified instances of the and classes.

An instance of the class that contains the information required to serialize the new instance. An instance of the class that indicates the source of the serialized stream that is associated with the new instance. Any attempt is made to access the constructor, when the constructor is not overridden in a descendant class.

When overridden by a descendant class, closes the response stream.

Any attempt is made to access the method, when the method is not overridden in a descendant class.

When overridden in a descendant class, gets or sets the content length of data being received.

The number of bytes returned from the Internet resource. Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

When overridden in a derived class, gets or sets the content type of the data being received.

A string that contains the content type of the response. Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Releases the unmanaged resources used by the object.

Releases the unmanaged resources used by the object, and optionally disposes of the managed resources.

true to release both managed and unmanaged resources; false to releases only unmanaged resources.

Populates a with the data that is needed to serialize the target object.

The to populate with data. A that specifies the destination for this serialization.

When overridden in a descendant class, returns the data stream from the Internet resource.

An instance of the class for reading data from the Internet resource. Any attempt is made to access the method, when the method is not overridden in a descendant class.

When overridden in a derived class, gets a collection of header name-value pairs associated with this request.

An instance of the class that contains header values associated with this response. Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Gets a value that indicates whether this response was obtained from the cache.

true if the response was taken from the cache; otherwise, false.

Gets a value that indicates whether mutual authentication occurred.

true if both client and server were authenticated; otherwise, false.

When overridden in a derived class, gets the URI of the Internet resource that actually responded to the request.

An instance of the class that contains the URI of the Internet resource that actually responded to the request. Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Gets a value that indicates if headers are supported.

Returns . true if headers are supported; otherwise, false.

Populates a instance with the data that is needed to serialize .

A that will hold the serialized data for the . A that contains the destination of the serialized stream that is associated with the new .

Specifies the meaning of time values that control caching behavior for resources obtained using objects.

Content can be taken from the cache until it is older than the age specified with this value.

and .

and .

Content can be taken from the cache after it has expired, until the time specified with this value elapses.

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.

For internal use only. The Framework will throw an if you try to use this member.

Specifies caching behavior for resources obtained using the Hypertext Transfer protocol (HTTP).

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.

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.

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 exception is thrown if the item is not in the client cache.

Satisfies a request for a resource either from the local computer's cache or a remote cache on the local area network. If the request cannot be satisfied, a exception is thrown. In the HTTP caching protocol, this is achieved using the only-if-cached cache control directive.

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.

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.

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 Pragma header.

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 Pragma header.

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.

Defines an application's caching requirements for resources obtained by using objects.

Initializes a new instance of the class.

Initializes a new instance of the class using the specified cache synchronization date.

A object that specifies the time when resources stored in the cache must be revalidated.

Initializes a new instance of the class using the specified cache policy.

An value.

Initializes a new instance of the class using the specified age control and time values.

One of the following enumeration values: , , or . A value that specifies an amount of time. The value specified for the cacheAgeControl parameter cannot be used with this constructor.

Initializes a new instance of the class using the specified maximum age, age control value, and time value.

An value. A value that specifies the maximum age for resources. A value that specifies an amount of time. The value specified for the cacheAgeControl parameter is not valid.

Initializes a new instance of the class using the specified maximum age, age control value, time value, and cache synchronization date.

An value. A value that specifies the maximum age for resources. A value that specifies an amount of time. A object that specifies the time when resources stored in the cache must be revalidated.

Gets the cache synchronization date for this instance.

A value set to the date specified when this instance was created. If no date was specified, this property's value is .

Gets the value that was specified when this instance was created.

A value that specifies the cache behavior for resources that were obtained using objects.

Gets the maximum age permitted for a resource returned from the cache.

A value that is set to the maximum age value specified when this instance was created. If no date was specified, this property's value is .

Gets the maximum staleness value that is permitted for a resource returned from the cache.

A value that is set to the maximum staleness value specified when this instance was created. If no date was specified, this property's value is .

Gets the minimum freshness that is permitted for a resource returned from the cache.

A value that specifies the minimum freshness specified when this instance was created. If no date was specified, this property's value is .

Returns a string representation of this instance.

A value that contains the property values for this instance.

Provides a file system implementation of the class.

Initializes a new instance of the class from the specified instances of the and classes.

A object that contains the information that is required to serialize the new object. A object that contains the source of the serialized stream that is associated with the new object.

Cancels a request to an Internet resource.

Begins an asynchronous request for a object to use to write data.

The delegate. An object that contains state information for this request. An that references the asynchronous request. The property is GET and the application writes to the stream. The stream is being used by a previous call to . No write stream is available. The was aborted.

Begins an asynchronous request for a file system resource.

The delegate. An object that contains state information for this request. An that references the asynchronous request. The stream is already in use by a previous call to . The was aborted.

Gets or sets the name of the connection group for the request. This property is reserved for future use.

The name of the connection group for the request.

Gets or sets the content length of the data being sent.

The number of bytes of request data being sent. is less than 0.

Gets or sets the content type of the data being sent. This property is reserved for future use.

The content type of the data being sent.

Gets or sets the credentials that are associated with this request. This property is reserved for future use.

An that contains the authentication credentials that are associated with this request. The default is null.

Ends an asynchronous request for a instance that the application uses to write data.

An that references the pending request for a stream. A object that the application uses to write data. asyncResult is null.

Ends an asynchronous request for a file system resource.

An that references the pending request for a response. A that contains the response from the file system resource. asyncResult is null.

Populates a with the data needed to serialize the target object.

The to populate with data. A that specifies the destination for this serialization.

Returns a object for writing data to the file system resource.

A for writing data to the file system resource. The request times out.

Returns a response to a file system request.

A that contains the response from the file system resource. The request timed out.

Gets a collection of the name/value pairs that are associated with the request. This property is reserved for future use.

A that contains header name/value pairs associated with this request.

Gets or sets the protocol method used for the request. This property is reserved for future use.

The protocol method to use in this request. The method is invalid. - or - The method is not supported. - or - Multiple methods were specified.

Gets or sets a value that indicates whether to preauthenticate a request. This property is reserved for future use.

true to preauthenticate; otherwise, false.

Gets or sets the network proxy to use for this request. This property is reserved for future use.

An that indicates the network proxy to use for this request.

Gets the Uniform Resource Identifier (URI) of the request.

A that contains the URI of the request.

Gets or sets the length of time until the request times out.

The time, in milliseconds, until the request times out, or the value to indicate that the request does not time out. The value specified is less than or equal to zero and is not .

Always throws a .

Always throws a . Default credentials are not supported for file Uniform Resource Identifiers (URIs).

Populates a object with the required data to serialize the .

A that holds the serialized data for the . A that contains the destination of the serialized stream that is associated with the new .

The exception that is thrown when an error is made while using a network protocol.

Initializes a new instance of the class.

Initializes a new instance of the class with the specified message.

The error message string.

Initializes a new instance of the class from the specified and instances.

A that contains the information that is required to deserialize the . A that contains the source of the serialized stream that is associated with the new .

Populates a with the data required to serialize the target object.

The to populate with data. A that specifies the destination for this serialization.

Serializes this instance into the specified object.

The object into which this will be serialized. The destination of the serialization.