Networking System [00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00 ] 1.0.x.x 1.0.5000.0 2.0.0.0 4.0.0.0 All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe. System.ComponentModel.Component System.Runtime.InteropServices.ComVisible(true)

The class provides common methods for sending data to or receiving data from any local, intranet, or Internet resource identified by a URI.

The class uses the class to provide access to resources. instances can access data with any descendant registered with the method.

By default, the .NET Framework supports URIs that begin with http:, https:, ftp:, and file: scheme identifiers.

The following table describes methods for uploading data to a resource.

Method

Description

Retrieves a used to send data to the resource.

Retrieves a used to send data to the resource, without blocking the calling thread.

Sends a byte array to the resource and returns a array containing any response.

Sends a array to the resource, without blocking the calling thread.

Sends a local file to the resource and returns a array containing any response.

Sends a local file to the resource, without blocking the calling thread.

Sends a to the resource and returns a array containing any response.

Sends a to the resource and returns a array containing any response, without blocking the calling thread.

Sends a to the resource, without blocking the calling thread.

Sends a to the resource, without blocking the calling thread.

The following table describes methods for downloading data from a resource.

Method

Description

Returns the data from a resource as a .

Returns the data from a resource, without blocking the calling thread.

Downloads data from a resource and returns a array.

Downloads data from a resource and returns a array, without blocking the calling thread.

Downloads data from a resource to a local file.

Downloads data from a resource to a local file, without blocking the calling thread.

Downloads a from a resource and returns a .

Downloads a from a resource, without blocking the calling thread.

You can use the method to cancel asynchronous operations that have not completed.

A instance does not send optional HTTP headers by default. If your request requires an optional header, you must add the header to the collection. For example, to retain queries in the response, you must add a user-agent header. Also, servers may return 500 (Internal Server Error) if the user agent header is missing.

is set to true in instances.

Provides common methods for sending data to and receiving data from a resource identified by a URI.

- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0

  The default constructor creates a new instance of the class. The default HTTP method is GET. The default FTP method is RETR. The default is . The default value of is true.

  Initializes a new instance of the class.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String

  A containing the base URI for requests made by a or, , if no value was set or was specified for a set operation.

  The value specified for a set operation is not or , and is not a URI in a format recognized by the class.

  The property contains a base URI that is combined with a relative address. When you call a method that uploads or downloads data, the object combines this base URI with the relative address you specify in the method call. If you specify an absolute URI, does not use the property value.

  To remove a previously set value, set this property to null or an empty string ("").

  Gets or sets the base URI for requests made by a .

  0
- Property
  2.0.0.0
  4.0.0.0
  System.MonoTODO("Value can be set but is currently ignored")
  System.Net.Cache.RequestCachePolicy To be added. To be added.

  Gets or sets the application's cache policy for any resources obtained by this WebClient instance using objects.

- Method
  2.0.0.0
  4.0.0.0
  System.Void

  If an operation is pending, this method calls on the underlying .

  When you call , your application still receives the completion event associated with the operation. For example, when you call to cancel a operation, if you have specified an event handler for the event, your event handler receives notification that the operation has ended. To learn whether the operation completed successfully, check the property on the base class of in the event data object passed to the event handler.

  If no asynchronous operation is in progress, this method does nothing.

  Cancels a pending asynchronous operation.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Net.ICredentials

  A containing the authentication credentials for the request. The default is .

  The property contains the authentication credentials used to access a resource on a host. In most client-side scenarios, you should use the , which are the credentials of the currently logged on user. To do this, set the property to true instead of setting this property.

  If the class is being used in a middle tier application, such as an ASP.NET application, the belong to the account running the ASP page (the server-side credentials). Typically, you would set this property to the credentials of the client on whose behalf the request is made.

  Gets or sets the network credentials that are sent to the host and used to authenticate the request.

  0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Byte[] ``

  The absolute URI is not valid.

  -or-

  An error occurred while downloading data.

  The method downloads the resource with the URI specified by the parameter. This method blocks while downloading the resource. To download a resource and continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Downloads the resource as a array from the URI specified.

  A array containing the downloaded resource.

  The URI from which to download data. 0
- Method
  2.0.0.0
  4.0.0.0
  System.Byte[] ``

  The method downloads the resource with the URI specified by the parameter. This method blocks while downloading the resource. To download a resource and continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  Note This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Downloads the resource as a array from the URI specified.

  A array containing the downloaded resource.

  The URI represented by the object, from which to download data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  This method retrieves the specified resource using the default method for the protocol associated with the URI scheme specified in . The data is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

  This method does not block the calling thread while downloading the resource. To download a resource and block while waiting for the server's response, use one of the methods. When the download completes, the event is raised. Your application must handle this event to receive notification. The downloaded data is available in the property.

  You can use the method to cancel asynchronous operations that have not completed.

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Downloads the resource as a array from the URI specified as an asynchronous operation.

  A containing the URI to download.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  This method retrieves the specified resource using the default method for the protocol associated with the URI scheme specified in . The data is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

  This method does not block the calling thread while downloading the resource. To download a resource and block while waiting for the server's response, use one of the methods. When the download completes, the event is raised. Your application must handle this event to receive notification. The downloaded data is available in the property.

  You can use the method to cancel asynchronous operations that have not completed.

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Downloads the resource as a array from the URI specified as an asynchronous operation.

  A containing the URI to download. A user-defined object that is passed to the method invoked when the asynchronous operation completes.
- Event
  2.0.0.0
  4.0.0.0
  System.Net.DownloadDataCompletedEventHandler

  This event is raised each time an asynchronous data download operation completes. Asynchronous data downloads are started by calling the methods.

  The is the delegate for this event. The class provides the event handler with event data.

  For more information about handling events, see Consuming Events.

  Occurs when an asynchronous data download operation completes.

- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Byte[]> ``

  This operation will not block. The returned object will complete after the data resource has been downloaded.

  This method retrieves the specified resource using the default method for the protocol associated with the URI scheme specified in the parameter. The data is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  The following code example requests data from a server and displays the data returned. It assumes that remoteUri contains a valid URI for the requested data.

  Downloads the resource as a array from the URI specified as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the downloaded resource.

  The URI of the resource to download.
- Method
  4.0.0.0
  System.Diagnostics.DebuggerStepThrough
  System.Runtime.CompilerServices.AsyncStateMachine(typeof(System.Net.WebClient/<DownloadDataTaskAsync>c__async0))
  System.Threading.Tasks.Task<System.Byte[]> ``

  This operation will not block. The returned object will complete after the data resource has been downloaded.

  This method retrieves the specified resource using the default method for the protocol associated with the URI scheme specified in the parameter. The data is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  Note This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Downloads the resource as a array from the URI specified as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the downloaded resource.

  The URI of the resource to download.
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  The absolute URI is not valid.

  -or-

  is or or contains invalid characters, or the specified path to the file does not exist.

  -or-

  An error occurred while downloading data.

  The caller does not have permission to write to local files. Requires permission to write to files. See .

  The method downloads to a local file data from the URI specified by in the parameter. This method blocks while downloading the resource. To download a resource and continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  When using this method in a middle tier application, such as an ASP.NET page, you will receive an error if the account under which the application executes does not have permission to access the file.

  Downloads the resource with the specified URI to a local file.

  The URI from which to download data. The name of the local file that is to receive the data. 0
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  The method downloads to a local file data from the URI specified by in the parameter. This method blocks while downloading the resource. To download a resource and continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  When using this method in a middle tier application, such as an ASP.NET page, you will receive an error if the account under which the application executes does not have permission to access the file.

  Downloads the resource with the specified URI to a local file.

  The URI specified as a , from which to download data. The name of the local file that is to receive the data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  This method downloads the resource at the URI specified by in the parameter. When the download completes successfully, the downloaded file is named on the local computer. The file is downloaded asynchronously using thread resources that are automatically allocated from the thread pool. To receive notification when the file is available, add an event handler to the event.

  This method does not block the calling thread while the resource is being downloaded. To block while waiting for the download to complete, use one of the methods.

  You can use the method to cancel asynchronous operations that have not completed.

  If the property is not an empty string ("") and does not specify an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  When using this method in an ASP.NET page, you will receive an error if the account that the page executes under does not have permission to access the local file.

  Downloads, to a local file, the resource with the specified URI. This method does not block the calling thread.

  The URI of the resource to download. The name of the file to be placed on the local computer.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` ``

  This method downloads the resource at the URI specified by in the parameter. When the download completes successfully, the downloaded file is named on the local computer. The file is downloaded asynchronously using thread resources that are automatically allocated from the thread pool. To receive notification when the file is available, add an event handler to the event.

  This method does not block the calling thread while the resource is being downloaded. To block while waiting for the download to complete, use one of the methods.

  You can use the method to cancel asynchronous operations that have not completed.

  If the property is not an empty string ("") and does not specify an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  When using this method in an ASP.NET page, you will receive an error if the account that the page executes under does not have permission to access the local file.

  Downloads, to a local file, the resource with the specified URI. This method does not block the calling thread.

  The URI of the resource to download. The name of the file to be placed on the local computer. A user-defined object that is passed to the method invoked when the asynchronous operation completes.
- Event
  2.0.0.0
  4.0.0.0
  System.ComponentModel.AsyncCompletedEventHandler

  This event is raised each time an asynchronous file download operation completes. Asynchronous file downloads are started by calling the methods.

  The is the delegate for this event. The class provides the event handler with event data.

  For more information about handling events, see Consuming Events.

  Occurs when an asynchronous file download operation completes.

- Method
  4.0.0.0
  System.Threading.Tasks.Task `` ``

  This operation will not block. The returned object will complete after the data resource has been downloaded.

  This method downloads the resource at the URI specified by in the parameter. When the download completes successfully, the downloaded file is named on the local computer. The file is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

  You can use the method to cancel asynchronous operations that have not completed.

  If the property is not an empty string ("") and does not specify an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  When using this method in an ASP.NET page, you will receive an error if the account that the page executes under does not have permission to access the local file.

  Downloads the specified resource to a local file as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation.

  The URI of the resource to download. The name of the file to be placed on the local computer.
- Method
  4.0.0.0
  System.Diagnostics.DebuggerStepThrough
  System.Runtime.CompilerServices.AsyncStateMachine(typeof(System.Net.WebClient/<DownloadFileTaskAsync>c__async4))
  System.Threading.Tasks.Task `` ``

  This operation will not block. The returned object will complete after the data resource has been downloaded.

  This method downloads the resource at the URI specified by in the parameter. When the download completes successfully, the downloaded file is named on the local computer. The file is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

  You can use the method to cancel asynchronous operations that have not completed.

  If the property is not an empty string ("") and does not specify an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  When using this method in an ASP.NET page, you will receive an error if the account that the page executes under does not have permission to access the local file.

  Downloads the specified resource to a local file as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation.

  The URI of the resource to download. The name of the file to be placed on the local computer.
- Event
  2.0.0.0
  4.0.0.0
  System.Net.DownloadProgressChangedEventHandler

  This event is raised each time an asynchronous download makes progress. This event is raised when downloads are started using any of the following methods.

  Method

  Description

  Downloads data from a resource and returns a array, without blocking the calling thread.

  Downloads data from a resource to a local file, without blocking the calling thread.

  Returns the data from a resource, without blocking the calling thread.

  The is the delegate for this event. The class provides the event handler with event data.

  For more information about handling events, see Consuming Events.

  A passive FTP file transfer will always show a progress percentage of zero, since the server did not send the file size. To show progress, you can change the FTP connection to active by overriding the virtual method:

  `internal class MyWebClient:WebClient{ protected override WebRequest GetWebRequest(Uri address) { FtpWebRequest req = (FtpWebRequest)base.GetWebRequest(address); req.UsePassive = false; return req; } }`

  Occurs when an asynchronous download operation successfully transfers some or all of the data.

- Method
  2.0.0.0
  4.0.0.0
  System.String ``

  This method retrieves the specified resource. After it downloads the resource, the method uses the encoding specified in the property to convert the resource to a . This method blocks while downloading the resource. To download a resource and continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Downloads the requested resource as a . The resource to download is specified as a containing the URI.

  A containing the requested resource.

  A containing the URI to download.
- Method
  2.0.0.0
  4.0.0.0
  System.String ``

  This method retrieves the specified resource. After it downloads the resource, the method uses the encoding specified in the property to convert the resource to a . This method blocks while downloading the resource. To download a resource and continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Downloads the requested resource as a . The resource to download is specified as a .

  A containing the requested resource.

  A object containing the URI to download.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  The resource is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

  After downloading the resource, this method uses the encoding specified in the property to convert the resource to a . This method does not block the calling thread while downloading the resource. To download a resource and block while waiting for the server's response, use the method. When the download completes, the event is raised. Your application must handle this event to receive notification. The downloaded string is available in the property.

  You can use the method to cancel asynchronous operations that have not completed.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Downloads the resource specified as a . This method does not block the calling thread.

  A containing the URI to download.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  The resource is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

  After downloading the resource, this method uses the encoding specified in the property to convert the resource to a . This method does not block the calling thread while downloading the resource. To download a resource and block while waiting for the server's response, use the method. When the download completes, the event is raised. Your application must handle this event to receive notification. The downloaded string is available in the property.

  You can use the method to cancel asynchronous operations that have not completed.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Downloads the specified string to the specified resource. This method does not block the calling thread.

  A containing the URI to download. A user-defined object that is passed to the method invoked when the asynchronous operation completes.
- Event
  2.0.0.0
  4.0.0.0
  System.Net.DownloadStringCompletedEventHandler

  This event is raised each time an asynchronous operation to download a resource as a string completes. These operations are started by calling the methods.

  The is the delegate for this event. The class provides the event handler with event data.

  For more information about handling events, see Consuming Events.

  Occurs when an asynchronous resource-download operation completes.

- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.String> ``

  This operation will not block. The returned object will complete after the data resource has been downloaded. The resource is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

  After downloading the resource, this method uses the encoding specified in the property to convert the resource to a . This method does not block the calling thread while downloading the resource.

  You can use the method to cancel asynchronous operations that have not completed.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Downloads the resource as a from the URI specified as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the downloaded resource.

  The URI of the resource to download.
- Method
  4.0.0.0
  System.Diagnostics.DebuggerStepThrough
  System.Runtime.CompilerServices.AsyncStateMachine(typeof(System.Net.WebClient/<DownloadStringTaskAsync>c__async7))
  System.Threading.Tasks.Task<System.String> ``

  This operation will not block. The returned object will complete after the data resource has been downloaded. The resource is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.

  After downloading the resource, this method uses the encoding specified in the property to convert the resource to a . This method does not block the calling thread while downloading the resource.

  You can use the method to cancel asynchronous operations that have not completed.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Downloads the resource as a from the URI specified as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the downloaded resource.

  The URI of the resource to download.
- Property
  2.0.0.0
  4.0.0.0
  System.Text.Encoding To be added.

  The and methods use this property to convert the specified string to a array before uploading the string. For additional information, see the method.

  When a string is downloaded using the or methods, uses the returned by this to convert the downloaded array into a string. For additional information, see the method.

  Gets and sets the used to upload and download strings.

- Method
  2.0.0.0
  4.0.0.0
  System.Net.WebRequest ``

  This method copies the existing , , and method to the newly created object.

  This method can be called only by classes that inherit from . It is provided to give inheritors access to the underlying object. Derived classes should call the base class implementation of to ensure the method works as expected.

  Returns a object for the specified resource.

  A new object for the specified resource.

  A that identifies the resource to request.
- Method
  2.0.0.0
  4.0.0.0
  System.Net.WebResponse ``

  The object returned by this method is obtained by calling the method on the specified object.

  This method can be called only by classes that inherit from . It is provided to give inheritors access to the underlying object.

  Returns the for the specified .

  A containing the response for the specified .

  A that is used to obtain the response.
- Method
  2.0.0.0
  4.0.0.0
  System.Net.WebResponse `` ``

  The object returned by this method is obtained by calling the method on the specified object.

  This method can be called only by classes that inherit from . It is provided to give inheritors access to the underlying object.

  Returns the for the specified using the specified .

  A containing the response for the specified .

  A that is used to obtain the response. An object obtained from a previous call to .
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Net.WebHeaderCollection

  A containing header name/value pairs associated with the request or, if this property has not been set or was set to , a new instance of the class.

  The property contains a instance containing protocol headers that the sends with the request.

  Some common headers are considered restricted and are protected by the system and cannot be set or changed in a object. Any attempt to set one of these restricted headers in the object associated with a object will throw an exception later when attempting to send the request.

  Restricted headers protected by the system include, but are not limited to the following:

  Date

  Host

  In addition, some other headers are also restricted when using a object. These restricted headers include, but are not limited to the following:

  Accept

  Connection

  Content-Length

  Expect (when the value is set to "100-continue"

  If-Modified-Since

  Range

  Transfer-Encoding

  The class has properties for setting some of the above headers. If it is important for an application to set these headers, then the class should be used instead of the class.

  You should not assume that the header values will remain unchanged, because Web servers and caches may change or add headers to a Web request.

  Gets or sets a collection of header name/value pairs associated with the request.

  0
- Property
  2.0.0.0
  4.0.0.0
  System.Boolean To be added. To be added.

  Gets whether a Web request is in progress.

- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from this class can override this method to perform additional tasks when the event occurs.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  A object that contains event data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from this class can override this method to perform additional tasks when the event occurs.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  An object containing event data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from this class can override this method to perform additional tasks when the event occurs.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  A object containing event data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from this class can override this method to perform additional tasks when the event occurs.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  A object containing event data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from this class can override this method to perform additional tasks when the event occurs.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  A object containing event data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from this class can override this method to perform additional tasks when the event occurs.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  A object containing event data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from this class can override this method to perform additional tasks when the event occurs.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  A object containing event data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from this class can override this method to perform additional tasks when the event occurs.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  An object containing event data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from this class can override this method to perform additional tasks when the event occurs.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  An object containing event data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from this class can override this method to perform additional tasks when the event occurs.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  An object containing event data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  Classes that inherit from this class can override this method to perform additional tasks when the event occurs.

  Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.

  The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

  Raises the event.

  A object containing event data.
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.IO.Stream ``

  The absolute URI is not valid.

  -or-

  An error occurred while downloading data.

  The method creates a instance used to read the contents of the resource specified by the parameter. This method blocks while opening the stream. To continue executing while waiting for the stream, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not null, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  You must call when finished with the to avoid running out of system resources.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a readable stream for the data downloaded from a resource with the URI specified as a .

  A used to read data from a resource.

  The URI specified as a from which to download data. 0
- Method
  2.0.0.0
  4.0.0.0
  System.IO.Stream ``

  The method creates a instance used to read the contents of the resource specified by the parameter. This method blocks while opening the stream. To continue executing while waiting for the stream, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not null, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  You must call when finished with the to avoid running out of system resources.

  Note This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a readable stream for the data downloaded from a resource with the URI specified as a

  A used to read data from a resource.

  The URI specified as a from which to download data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  This method retrieves a instance used to access the resource specified by the parameter. The stream is obtained using thread resources that are automatically allocated from the thread pool. To receive notification when the stream is available, add an event handler to the event.

  You must call when you are finished with the to avoid running out of system resources.

  This method does not block the calling thread while the stream is opening. To block while waiting for the stream, use the method.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not specify an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested resource. If the property is not null, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a readable stream containing the specified resource. This method does not block the calling thread.

  The URI of the resource to retrieve.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  This method retrieves a instance used to access the resource specified by the parameter. The stream is obtained using thread resources that are automatically allocated from the thread pool. To receive notification when the stream is available, add an event handler to the event.

  You must call when you are finished with the to avoid running out of system resources.

  This method does not block the calling thread while the stream is opening. To block while waiting for the stream, use the method.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not specify an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested resource. If the property is not null, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a readable stream containing the specified resource. This method does not block the calling thread.

  The URI of the resource to retrieve. A user-defined object that is passed to the method invoked when the asynchronous operation completes.
- Event
  2.0.0.0
  4.0.0.0
  System.Net.OpenReadCompletedEventHandler

  This event is raised each time an asynchronous operation to open a stream containing a resource completes. These operations are started by calling the methods.

  The is the delegate for this event. The class provides the event handler with event data.

  For more information about handling events, see Consuming Events.

  Occurs when an asynchronous operation to open a stream containing a resource completes.

- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.IO.Stream> ``

  This operation will not block. The returned object will complete after the a readable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.

  This method retrieves a instance used to access the resource specified by the parameter. The stream is obtained using thread resources that are automatically allocated from the thread pool.

  You must call when you are finished with the to avoid running out of system resources.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not specify an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested resource. If the property is not null, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a used to read data from a resource.

  The URI of the resource to retrieve.
- Method
  4.0.0.0
  System.Diagnostics.DebuggerStepThrough
  System.Runtime.CompilerServices.AsyncStateMachine(typeof(System.Net.WebClient/<OpenReadTaskAsync>c__async6))
  System.Threading.Tasks.Task<System.IO.Stream> ``

  This operation will not block. The returned object will complete after the a readable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.

  This method retrieves a instance used to access the resource specified by the parameter. The stream is obtained using thread resources that are automatically allocated from the thread pool.

  You must call when you are finished with the to avoid running out of system resources.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not specify an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested resource. If the property is not null, it is appended to .

  This method uses the RETR command to download an FTP resource. For an HTTP resource, the GET method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a used to read data from a resource.

  The URI of the resource to retrieve.
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.IO.Stream ``

  The absolute URI is not valid.

  -or-

  An error occurred while opening the stream.

  The method returns a writable stream that is used to send data to a resource. This method blocks while opening the stream. To continue executing while waiting for the stream, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a stream for writing data to the specified resource.

  A used to write data to the resource.

  The URI of the resource to receive the data. 0
- Method
  2.0.0.0
  4.0.0.0
  System.IO.Stream ``

  The method returns a writable stream that is used to send data to a resource. This method blocks while opening the stream. To continue executing while waiting for the stream, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a stream for writing data to the specified resource.

  A used to write data to the resource.

  The URI of the resource to receive the data.
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.IO.Stream `` ``

  The absolute URI is not valid.

  -or-

  An error occurred while opening the stream.

  The method returns a writable stream that is used to send data to a resource. The underlying request is made with the method specified in the parameter. The data is sent to the server when you close the stream. This method blocks while opening the stream. To continue executing while waiting for the stream, use one of the methods.

  If the parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the property is not an empty string ("") and does not specify an absolute address, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a stream for writing data to the specified resource, using the specified method.

  A used to write data to the resource.

  The URI of the resource to receive the data. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. 0
- Method
  2.0.0.0
  4.0.0.0
  System.IO.Stream `` ``

  The method returns a writable stream that is used to send data to a resource. This method blocks while opening the stream. To continue executing while waiting for the stream, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a stream for writing data to the specified resource, by using the specified method.

  A used to write data to the resource.

  The URI of the resource to receive the data. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp.
- Method
  2.0.0.0
  4.0.0.0
  System.Void ``

  This method retrieves a writable stream that is used to send data to a resource. The stream is retrieved using thread resources that are automatically allocated from the thread pool. To receive notification when the stream is available, add an event handler to the event. When you close the stream, the thread blocks until the request is sent to and a response is received.

  This method does not block the calling thread while the stream is being opened. To block while waiting for the stream, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a stream for writing data to the specified resource. This method does not block the calling thread.

  The URI of the resource to receive the data.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  This method retrieves a writable stream that is used to send data to a resource. The stream is retrieved using thread resources that are automatically allocated from the thread pool. To receive notification when the stream is available, add an event handler to the event. When you close the stream, the thread blocks until the request is sent to and a response is received.

  This method does not block the calling thread while the stream is being opened. To block while waiting for the stream, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a stream for writing data to the specified resource. This method does not block the calling thread.

  The URI of the resource to receive the data. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` ``

  This method retrieves a writable stream that is used to send data to a resource. The stream is retrieved asynchronously using thread resources that are automatically allocated from the thread pool. To receive notification when the stream is available, add an event handler to the event. The contents of the stream are sent to the server when you close the stream.

  If the parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  Asynchronous operations that have not completed can be canceled using the method.

  This method does not block the calling thread while the stream is being opened. To block while waiting for the stream, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a stream for writing data to the specified resource, using the specified method. This method does not block the calling thread.

  The URI of the resource to receive the data. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. A user-defined object that is passed to the method invoked when the asynchronous operation completes
- Event
  2.0.0.0
  4.0.0.0
  System.Net.OpenWriteCompletedEventHandler

  This event is raised each time an asynchronous operation to open a stream that is used to send data to a resource completes. These operations are started by calling the methods.

  The is the delegate for this event. The class provides the event handler with event data.

  For more information about handling events, see Consuming Events.

  Occurs when an asynchronous operation to open a stream to write data to a resource completes.

- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.IO.Stream> ``

  This operation will not block. The returned object will complete after the a writable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.

  This method retrieves a instance used to write data to the resource specified by the parameter. The stream is obtained using thread resources that are automatically allocated from the thread pool.

  You must call when you are finished with the to avoid running out of system resources.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a used to write data to the resource.

  The URI of the resource to receive the data.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.IO.Stream> ``

  This operation will not block. The returned object will complete after the a writable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.

  This method retrieves a instance used to write data to the resource specified by the parameter. The stream is obtained using thread resources that are automatically allocated from the thread pool.

  You must call when you are finished with the to avoid running out of system resources.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a used to write data to the resource.

  The URI of the resource to receive the data.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.IO.Stream> `` ``

  This operation will not block. The returned object will complete after the a writable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.

  This method retrieves a instance used to write data to the resource specified by the parameter. The stream is obtained using thread resources that are automatically allocated from the thread pool.

  You must call when you are finished with the to avoid running out of system resources.

  If the parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a used to write data to the resource.

  The URI of the resource to receive the data. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp.
- Method
  4.0.0.0
  System.Diagnostics.DebuggerStepThrough
  System.Runtime.CompilerServices.AsyncStateMachine(typeof(System.Net.WebClient/<OpenWriteTaskAsync>c__async8))
  System.Threading.Tasks.Task<System.IO.Stream> `` ``

  This operation will not block. The returned object will complete after the a writable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.

  This method retrieves a instance used to write data to the resource specified by the parameter. The stream is obtained using thread resources that are automatically allocated from the thread pool.

  You must call when you are finished with the to avoid running out of system resources.

  If the parameter specifies a method that is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a used to write data to the resource.

  The URI of the resource to receive the data. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp.
- Property
  2.0.0.0
  4.0.0.0
  System.Net.IWebProxy To be added.

  The property identifies the instance that communicates with remote servers on behalf of this object. The proxy is set by the system using configuration files and the Internet Explorer Local Area Network settings. To specify that no proxy should be used, set the property to the proxy instance returned by the method.

  For information on automatic proxy detection, see Automatic Proxy Detection.

  Gets or sets the proxy used by this object.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Collections.Specialized.NameValueCollection

  A that contains query name/value pairs associated with the request or, if this property has not been set or was set to , a new instance of the class.

  The property contains a instance containing name/value pairs that are appended to the URI as a query string. The contents of the property are preceded by a question mark (?), and name/value pairs are separated from one another by an ampersand (&).

  Gets or sets a collection of query name/value pairs associated with the request.

  0
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Net.WebHeaderCollection

  A containing header name/value pairs associated with the response.

  The property contains a instance containing header information the receives with the response.

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

  0
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Byte[] `` ``

  The absolute URI is not valid.

  -or-

  is .

  -or-

  An error occurred while opening the stream or uploading the data.

  -or-

  There was no response from the server hosting the resource.

  The method sends a data buffer to a resource.

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used. If the underlying request is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  The method sends the content of to the server without encoding it. This method blocks while uploading the data. To continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads a data buffer to a resource identified by a URI.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the data. The data buffer to send to the resource. 0
- Method
  2.0.0.0
  4.0.0.0
  System.Byte[] `` ``

  The method sends a data buffer to a resource.

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used. If the underlying request is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  The method sends the content of to the server without encoding it. This method blocks while uploading the data. To continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads a data buffer to a resource identified by a URI.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the data. The data buffer to send to the resource.
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Byte[] `` `` ``

  The absolute URI is not valid.

  -or-

  is .

  -or-

  An error occurred while opening the stream or uploading the data.

  -or-

  There was no response from the server hosting the resource.

  The method sends a data buffer to a resource using the HTTP method specified in the parameter, and returns any response from the server. This method blocks while uploading the data. To continue executing while waiting for the server's response, use one of the methods.

  The method sends the content of to the server without encoding it.

  If the parameter specifies a verb that is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads a data buffer to the specified resource, using the specified method.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the data. The HTTP method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. The data buffer to send to the resource. 0
- Method
  2.0.0.0
  4.0.0.0
  System.Byte[] `` `` ``

  The method sends a data buffer to a resource using the HTTP method specified in the parameter, and returns any response from the server. This method blocks while uploading the data. To continue executing while waiting for the server's response, use one of the methods.

  The method sends the content of to the server without encoding it.

  If the parameter specifies a verb that is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads a data buffer to the specified resource, using the specified method.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the data. The HTTP method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. The data buffer to send to the resource.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  This method sends a data buffer to a resource. The data buffer is sent asynchronously using thread resources that are automatically allocated from the thread pool. The data is not encoded. To receive notification when the data upload completes, add an event handler to the event.

  This method does not block the calling thread while the data is being sent. To send data and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads a data buffer to a resource identified by a URI, using the POST method. This method does not block the calling thread.

  The URI of the resource to receive the data. The data buffer to send to the resource.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` ``

  This method sends a data buffer to a resource. The data buffer is sent asynchronously using thread resources that are automatically allocated from the thread pool. The data is not encoded. To receive notification when the data upload completes, add an event handler to the event.

  This method does not block the calling thread while the data is being sent. To send data and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads a data buffer to a resource identified by a URI, using the specified method. This method does not block the calling thread.

  The URI of the resource to receive the data. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. The data buffer to send to the resource.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` `` ``

  This method sends a data buffer to a resource. The data buffer is sent asynchronously using thread resources that are automatically allocated from the thread pool. The data is not encoded. To receive notification when the data upload completes, add an event handler to the event.

  This method does not block the calling thread while the data is being sent. To send data and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads a data buffer to a resource identified by a URI, using the specified method and identifying token.

  The URI of the resource to receive the data. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. The data buffer to send to the resource. A user-defined object that is passed to the method invoked when the asynchronous operation completes.
- Event
  2.0.0.0
  4.0.0.0
  System.Net.UploadDataCompletedEventHandler

  This event is raised each time an asynchronous data upload operation completes. Asynchronous data uploads are started by calling the methods.

  The is the delegate for this event. The class provides the event handler with event data.

  For more information about handling events, see Consuming Events.

  Occurs when an asynchronous data-upload operation completes.

- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Byte[]> `` ``

  This operation will not block. The returned object will complete after the a data buffer has been uploaded to the resource.

  This method sends a data buffer to a resource. The data buffer is sent asynchronously using thread resources that are automatically allocated from the thread pool. The data is not encoded.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads a data buffer that contains a array to the URI specified as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the body of the response received from the resource when the data buffer was uploaded.

  The URI of the resource to receive the data. The data buffer to send to the resource.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Byte[]> `` ``

  This operation will not block. The returned object will complete after the a data buffer has been uploaded to the resource.

  This method sends a data buffer to a resource. The data buffer is sent asynchronously using thread resources that are automatically allocated from the thread pool. The data is not encoded.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads a data buffer that contains a array to the URI specified as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the body of the response received from the resource when the data buffer was uploaded.

  The URI of the resource to receive the data. The data buffer to send to the resource.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Byte[]> `` `` ``

  This operation will not block. The returned object will complete after the a data buffer has been uploaded to the resource.

  This method sends a data buffer to a resource. The data buffer is sent asynchronously using thread resources that are automatically allocated from the thread pool. The data is not encoded.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads a data buffer that contains a array to the URI specified as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the body of the response received from the resource when the data buffer was uploaded.

  The URI of the resource to receive the data. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. The data buffer to send to the resource.
- Method
  4.0.0.0
  System.Diagnostics.DebuggerStepThrough
  System.Runtime.CompilerServices.AsyncStateMachine(typeof(System.Net.WebClient/<UploadDataTaskAsync>c__async9))
  System.Threading.Tasks.Task<System.Byte[]> `` `` ``

  This operation will not block. The returned object will complete after the a data buffer has been uploaded to the resource.

  This method sends a data buffer to a resource. The data buffer is sent asynchronously using thread resources that are automatically allocated from the thread pool. The data is not encoded.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads a data buffer that contains a array to the URI specified as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the body of the response received from the resource when the data buffer was uploaded.

  The URI of the resource to receive the data. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. The data buffer to send to the resource.
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Byte[] `` ``

  The absolute URI is not valid.

  -or-

  is or or contains invalid characters, or the specified path to the file does not exist.

  -or-

  An error occurred while opening the stream or uploading the file.

  -or-

  There was no response from the server hosting the resource.

  -or-

  The Content-Type header begins with "multipart".

  Local file access has not been granted. Requires permission to access path information and read files. See and .

  The method sends a local file to a resource. This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This method blocks while uploading the file. To continue executing while waiting for the server's response, use one of the methods.

  The POST method is defined by HTTP. If the underlying request does not use HTTP and POST is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified local file to a resource with the specified URI.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the file. For example, ftp://localhost/samplefile.txt. The file to send to the resource. For example, "samplefile.txt". 0
- Method
  2.0.0.0
  4.0.0.0
  System.Byte[] `` ``

  The method sends a local file to a resource. This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This method blocks while uploading the file. To continue executing while waiting for the server's response, use one of the methods.

  The POST method is defined by HTTP. If the underlying request does not use HTTP and POST is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified local file to a resource with the specified URI.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the file. For example, ftp://localhost/samplefile.txt. The file to send to the resource. For example, "samplefile.txt".
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Byte[] `` `` ``

  The absolute URI is not valid.

  -or-

  is or or contains invalid characters, or the specified path to the file does not exist.

  -or-

  An error occurred while opening the stream or uploading the file.

  -or-

  There was no response from the server hosting the resource.

  -or-

  The Content-Type header begins with "multipart".

  The caller does not have the required permissions. Requires permission to access path information and read files. See and .

  When address specifies an HTTP resource, the method sends a local file to a resource using the HTTP method specified in the parameter and returns any response from the server. This method blocks while uploading the file. To continue executing while waiting for the server's response, use one of the methods.

  If the parameter specifies a verb that is not understood by the server or the resource, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified local file to the specified resource, using the specified method.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the file. The method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. The file to send to the resource. 0
- Method
  2.0.0.0
  4.0.0.0
  System.Byte[] `` `` ``

  When address specifies an HTTP resource, the method sends a local file to a resource using the HTTP method specified in the parameter and returns any response from the server. This method blocks while uploading the file. To continue executing while waiting for the server's response, use one of the methods.

  If the parameter specifies a verb that is not understood by the server or the resource, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified local file to the specified resource, using the specified method.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the file. The method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. The file to send to the resource.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  The file is sent asynchronously using thread resources that are automatically allocated from the thread pool. To receive notification when the file upload completes, add an event handler to the event.

  This method does not block the calling thread while the file is being sent. To send a file and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified local file to the specified resource, using the POST method. This method does not block the calling thread.

  The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The file to send to the resource.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` ``

  The file is sent asynchronously using thread resources that are automatically allocated from the thread pool. To receive notification when the file upload completes, add an event handler to the event.

  This method does not block the calling thread while the file is being sent. To send a file and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified local file to the specified resource, using the POST method. This method does not block the calling thread.

  The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. The file to send to the resource.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` `` ``

  The file is sent asynchronously using thread resources that are automatically allocated from the thread pool. To receive notification when the file upload completes, add an event handler to the event.

  This method does not block the calling thread while the file is being sent. To send a file and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified local file to the specified resource, using the POST method. This method does not block the calling thread.

  The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. The file to send to the resource. A user-defined object that is passed to the method invoked when the asynchronous operation completes.
- Event
  2.0.0.0
  4.0.0.0
  System.Net.UploadFileCompletedEventHandler

  This event is raised each time an asynchronous file upload operation completes. Asynchronous file uploads are started by calling the methods.

  The is the delegate for this event. The class provides the event handler with event data.

  For more information about handling events, see Consuming Events.

  Occurs when an asynchronous file-upload operation completes.

- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Byte[]> `` ``

  This operation will not block. The returned object will complete after the file has been uploaded to the resource. The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified local file to a resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the body of the response received from the resource when the file was uploaded.

  The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The local file to send to the resource.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Byte[]> `` ``

  This operation will not block. The returned object will complete after the file has been uploaded to the resource. The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified local file to a resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the body of the response received from the resource when the file was uploaded.

  The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The local file to send to the resource.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Byte[]> `` `` ``

  This operation will not block. The returned object will complete after the file has been uploaded to the resource. The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  BY default, this method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified local file to a resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the body of the response received from the resource when the file was uploaded.

  The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. The local file to send to the resource.
- Method
  4.0.0.0
  System.Diagnostics.DebuggerStepThrough
  System.Runtime.CompilerServices.AsyncStateMachine(typeof(System.Net.WebClient/<UploadFileTaskAsync>c__asyncB))
  System.Threading.Tasks.Task<System.Byte[]> `` `` ``

  This operation will not block. The returned object will complete after the file has been uploaded to the resource. The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string (""), must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  BY default, this method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified local file to a resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the body of the response received from the resource when the file was uploaded.

  The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The method used to send the data to the resource. If null, the default is POST for http and STOR for ftp. The local file to send to the resource.
- Event
  2.0.0.0
  4.0.0.0
  System.Net.UploadProgressChangedEventHandler

  This event is raised each time an asynchronous upload makes progress. This event is raised when uploads are started using any of the following methods.

  Method

  Description

  Sends a array to the resource, without blocking the calling thread.

  Sends a local file to the resource, without blocking the calling thread.

  Sends a to the resource and returns a array containing any response, without blocking the calling thread.

  The is the delegate for this event. The class provides the event handler with event data.

  For more information about handling events, see Consuming Events.

  Occurs when an asynchronous upload operation successfully transfers some or all of the data.

- Method
  2.0.0.0
  4.0.0.0
  System.String `` ``

  Before uploading the string, this method converts it to a array using the encoding specified in the property. This method blocks while the string is transmitted. To send a string and continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string (""), and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified string to the specified resource, using the POST method.

  A containing the response sent by the server.

  The URI of the resource to receive the string. For Http resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The string to be uploaded.
- Method
  2.0.0.0
  4.0.0.0
  System.String `` ``

  Before uploading the string, this method converts it to a array using the encoding specified in the property. This method blocks while the string is transmitted. To send a string and continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string (""), and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified string to the specified resource, using the POST method.

  A containing the response sent by the server.

  The URI of the resource to receive the string. For Http resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The string to be uploaded.
- Method
  2.0.0.0
  4.0.0.0
  System.String `` `` ``

  Before uploading the string, this method converts it to a array using the encoding specified in the property. This method blocks while the string is transmitted. To send a string and continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified string to the specified resource, using the specified method.

  A containing the response sent by the server.

  The URI of the resource to receive the string. This URI must identify a resource that can accept a request sent with the method. The HTTP method used to send the string to the resource. If null, the default is POST for http and STOR for ftp. The string to be uploaded.
- Method
  2.0.0.0
  4.0.0.0
  System.String `` `` ``

  Before uploading the string, this method converts it to a array using the encoding specified in the property. This method blocks while the string is transmitted. To send a string and continue executing while waiting for the server's response, use one of the methods.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified string to the specified resource, using the specified method.

  A containing the response sent by the server.

  The URI of the resource to receive the string. This URI must identify a resource that can accept a request sent with the method. The HTTP method used to send the string to the resource. If null, the default is POST for http and STOR for ftp. The string to be uploaded.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  This method sends a string to a resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool. Before uploading the string, this method converts it to a array using the encoding specified in the property. To receive notification when the string upload completes, you can add an event handler to the event.

  This method does not block the calling thread while the string is being sent. To send a string and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified string to the specified resource. This method does not block the calling thread.

  The URI of the resource to receive the string. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The string to be uploaded.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` ``

  This method sends a string to a resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool. Before uploading the string, this method converts it to a array using the encoding specified in the property. To receive notification when the string upload completes, you can add an event handler to the event.

  This method does not block the calling thread while the string is being sent. To send a string and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified string to the specified resource. This method does not block the calling thread.

  The URI of the resource to receive the string. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. The string to be uploaded.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` `` ``

  This method sends a string to a resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool. Before uploading the string, this method converts it to a array using the encoding specified in the property. To receive notification when the string upload completes, you can add an event handler to the event.

  This method does not block the calling thread while the string is being sent. To send a string and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified string to the specified resource. This method does not block the calling thread.

  The URI of the resource to receive the string. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. The string to be uploaded. A user-defined object that is passed to the method invoked when the asynchronous operation completes.
- Event
  2.0.0.0
  4.0.0.0
  System.Net.UploadStringCompletedEventHandler

  This event is raised each time an asynchronous string upload operation completes. Asynchronous string uploads are started by calling the methods.

  The is the delegate for this event. The class provides the event handler with event data.

  For more information about handling events, see .

  Occurs when an asynchronous string-upload operation completes.

- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.String> `` ``

  This operation will not block. The returned object will complete after the string has been uploaded to the resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  Before uploading the string, this method converts it to a array using the encoding specified in the property. This method blocks while the string is transmitted.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified string to the specified resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a containing the response sent by the server.

  The URI of the resource to receive the string. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The string to be uploaded.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.String> `` ``

  This operation will not block. The returned object will complete after the string has been uploaded to the resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  Before uploading the string, this method converts it to a array using the encoding specified in the property. This method blocks while the string is transmitted.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified string to the specified resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a containing the response sent by the server.

  The URI of the resource to receive the string. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The string to be uploaded.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.String> `` `` ``

  This operation will not block. The returned object will complete after the string has been uploaded to the resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  Before uploading the string, this method converts it to a array using the encoding specified in the property. This method blocks while the string is transmitted.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified string to the specified resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a containing the response sent by the server.

  The URI of the resource to receive the string. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. The string to be uploaded.
- Method
  4.0.0.0
  System.Diagnostics.DebuggerStepThrough
  System.Runtime.CompilerServices.AsyncStateMachine(typeof(System.Net.WebClient/<UploadStringTaskAsync>c__asyncD))
  System.Threading.Tasks.Task<System.String> `` `` ``

  This operation will not block. The returned object will complete after the string has been uploaded to the resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  Before uploading the string, this method converts it to a array using the encoding specified in the property. This method blocks while the string is transmitted.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified string to the specified resource as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a containing the response sent by the server.

  The URI of the resource to receive the string. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. The string to be uploaded.
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Byte[] `` ``

  The absolute URI is not valid.

  -or-

  is .

  -or-

  An error occurred while opening the stream or uploading the data.

  -or-

  There was no response from the server hosting the resource.

  -or-

  The Content-Type header is not , and is not "application/x-www-form-urlencoded".

  The method sends a to a server. This method blocks while uploading the data. To continue executing while waiting for the server's response, use one of the methods.

  If the underlying request is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the Content-type header is null, the method sets it to "application/x-www-form-urlencoded".

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified name/value collection to the resource identified by the specified URI.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the collection. The to send to the resource. 0
- Method
  2.0.0.0
  4.0.0.0
  System.Byte[] `` ``

  The method sends a to a server. This method blocks while uploading the data. To continue executing while waiting for the server's response, use one of the methods.

  If the underlying request is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the Content-type header is null, the method sets it to "application/x-www-form-urlencoded".

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified name/value collection to the resource identified by the specified URI.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the collection. The to send to the resource.
- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Byte[] `` `` ``

  The absolute URI is not valid.

  -or-

  is .

  -or-

  An error occurred while opening the stream or uploading the data.

  -or-

  There was no response from the server hosting the resource.

  -or-

  The Content-Type header is not , and is not "application/x-www-form-urlencoded".

  The method sends a to a resource using the method specified in the parameter and returns any response from the server. This method blocks while uploading the data. To continue executing while waiting for the server's response, use one of the methods.

  If the Content-type header is null, the method sets it to application/x-www-form-urlencoded.

  If the parameter specifies a verb that is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified name/value collection to the resource identified by the specified URI, using the specified method.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the collection. The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. The to send to the resource. 0
- Method
  2.0.0.0
  4.0.0.0
  System.Byte[] `` `` ``

  The method sends a to a resource using the method specified in the parameter and returns any response from the server. This method blocks while uploading the data. To continue executing while waiting for the server's response, use one of the methods.

  If the Content-type header is null, the method sets it to application/x-www-form-urlencoded.

  If the parameter specifies a verb that is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified name/value collection to the resource identified by the specified URI, using the specified method.

  A array containing the body of the response from the resource.

  The URI of the resource to receive the collection. The HTTP method used to send the file to the resource. If null, the default is POST for http and STOR for ftp. The to send to the resource.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` ``

  This method sends a string to a resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool. Before uploading the string, this method converts it to a array using the encoding specified in the property. To receive notification when the string upload completes, you can add an event handler to the event.

  This method does not block the calling thread while the string is being sent. To send a string and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the data in the specified name/value collection to the resource identified by the specified URI. This method does not block the calling thread.

  The URI of the resource to receive the collection. This URI must identify a resource that can accept a request sent with the default method. See remarks. The to send to the resource.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` ``

  This method sends the data contained in a to the resource. Use this method to send form data to a URI for processing. The data is sent using the form-urlencoded media type; the Content-Type header value must be set to "application/x-www-form-urlencoded". The header is set correctly by default. The methods throw a if you call this method with a different Content-Type header value set in the collection.

  If the method is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  The is sent asynchronously using thread resources that are automatically allocated from the thread pool. To receive notification when the upload operation completes, add an event handler to the event.

  This method does not block the calling thread while the string is being sent. To send a string and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not empty, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information see Network Tracing.

  Uploads the data in the specified name/value collection to the resource identified by the specified URI, using the specified method. This method does not block the calling thread.

  The URI of the resource to receive the collection. This URI must identify a resource that can accept a request sent with the method. The method used to send the string to the resource. If null, the default is POST for http and STOR for ftp. The to send to the resource.
- Method
  2.0.0.0
  4.0.0.0
  System.Void `` `` `` ``

  This method sends the data contained in a to the resource. Use this method to send form data to a URI for processing. The data is sent using the form-urlencoded media type; the Content-Type header value must be set to "application/x-www-form-urlencoded". The header is set correctly by default. The methods throw a if you call this method with a different Content-Type header value set in the collection.

  If the method is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  The is sent asynchronously using thread resources that are automatically allocated from the thread pool. To receive notification when the upload operation completes, add an event handler to the event.

  This method does not block the calling thread while the string is being sent. To send a string and block while waiting for the server's response, use one of the methods.

  Asynchronous operations that have not completed can be canceled using the method.

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not empty, it is appended to .

  This member outputs trace information when you enable network tracing in your application. For more information see Network Tracing.

  Uploads the data in the specified name/value collection to the resource identified by the specified URI, using the specified method. This method does not block the calling thread, and allows the caller to pass an object to the method that is invoked when the operation completes.

  The URI of the resource to receive the collection. This URI must identify a resource that can accept a request sent with the method. The HTTP method used to send the string to the resource. If null, the default is POST for http and STOR for ftp. The to send to the resource. A user-defined object that is passed to the method invoked when the asynchronous operation completes.
- Event
  2.0.0.0
  4.0.0.0
  System.Net.UploadValuesCompletedEventHandler

  This event is raised each time an asynchronous upload of a object's data completes. These uploads are started by calling the methods.

  The is the delegate for this event. The class provides the event handler with event data.

  For more information about handling events, see Consuming Events.

  Occurs when an asynchronous upload of a name/value collection completes.

- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Byte[]> `` ``

  This operation will not block. The returned object will complete after the name/value collection has been uploaded to the resource. The name/value collection is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  If the underlying request is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the Content-type header is null, this method sets it to "application/x-www-form-urlencoded".

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the response sent by the server.

  The URI of the resource to receive the collection. The to send to the resource.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Byte[]> `` ``

  This operation will not block. The returned object will complete after the name/value collection has been uploaded to the resource. The name/value collection is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  If the underlying request is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the Content-type header is null, this method sets it to "application/x-www-form-urlencoded".

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the response sent by the server.

  The URI of the resource to receive the collection. The to send to the resource.
- Method
  4.0.0.0
  System.Threading.Tasks.Task<System.Byte[]> `` `` ``

  This operation will not block. The returned object will complete after the name/value collection has been uploaded to the resource. The name/value collection is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  If the underlying request is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the Content-type header is null, this method sets it to "application/x-www-form-urlencoded".

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the response sent by the server.

  The URI of the resource to receive the collection. The HTTP method used to send the collection to the resource. If null, the default is POST for http and STOR for ftp. The to send to the resource.
- Method
  4.0.0.0
  System.Diagnostics.DebuggerStepThrough
  System.Runtime.CompilerServices.AsyncStateMachine(typeof(System.Net.WebClient/<UploadValuesTaskAsync>c__asyncE))
  System.Threading.Tasks.Task<System.Byte[]> `` `` ``

  This operation will not block. The returned object will complete after the name/value collection has been uploaded to the resource. The name/value collection is sent asynchronously using thread resources that are automatically allocated from the thread pool.

  Asynchronous operations that have not completed can be canceled using the method.

  If the underlying request is not understood by the server, the underlying protocol classes determine what occurs. Typically, a is thrown with the property set to indicate the error.

  If the Content-type header is null, this method sets it to "application/x-www-form-urlencoded".

  If the property is not an empty string ("") and does not contain an absolute URI, must be a relative URI that is combined with to form the absolute URI of the requested data. If the property is not an empty string, it is appended to .

  This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.

  This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing.

  Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.

  Returns .

  The task object representing the asynchronous operation. The property on the task object returns a array containing the response sent by the server.

  The URI of the resource to receive the collection. The HTTP method used to send the collection to the resource. If null, the default is POST for http and STOR for ftp. The to send to the resource.
- Property
  2.0.0.0
  4.0.0.0
  System.MonoTODO("Value can be set but is ignored")
  System.Boolean To be added.

  Set this property to true when requests made by this object should, if requested by the server, be authenticated using the default credentials of the currently logged on user. For client applications, this is the desired behavior in most scenarios. For middle tier applications, such as ASP.NET applications, instead of using this property, you would typically set the property to the credentials of the client on whose behalf the request is made.

  Gets or sets a value that controls whether the are sent with requests.

0