.NETFramework:System.Net.WebClient.cs

ylbtech-.NETFramework:System.Net.WebClient.cs
提供用于将数据发送到和接收来自通过 URI 确认的资源数据的常用方法
1.返回顶部
1、
#region 程序集 System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
// C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.7\System.dll
#endregion

using System.Collections.Specialized;
using System.ComponentModel;
using System.IO;
using System.Net.Cache;
using System.Runtime.InteropServices;
using System.Text;
using System.Threading.Tasks;

namespace System.Net
{
    //
    // 摘要:
    //     提供用于将数据发送到和接收来自通过 URI 确认的资源数据的常用方法。
    [ComVisible( true )]
    public class WebClient : Component
    {
        //
        // 摘要:
        //     初始化 System.Net.WebClient 类的新实例。
        public WebClient();

        //
        // 摘要:
        //     获取或设置一个值,该值指示是否缓冲数据写入 Internet 资源的 System.Net.WebClient 实例。
        //
        // 返回结果:
        //     返回 System.Boolean。 true 若要启用对写入 Internet 资源中; 的数据进行缓冲 false 禁用缓冲处理。 默认值为 true。
        [EditorBrowsable( EditorBrowsableState.Never )]
        [Obsolete( "This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true )]
        public bool AllowWriteStreamBuffering { get; set; }
        //
        // 摘要:
        //     获取和设置 System.Text.Encoding 用于上载和下载字符串。
        //
        // 返回结果:
        //     一个 System.Text.Encoding 用来对字符串进行编码。 此属性的默认值是由返回的编码 System.Text.Encoding.Default。
        public Encoding Encoding { get; set; }
        //
        // 摘要:
        //     获取或设置发出的请求的基 URI System.Net.WebClient。
        //
        // 返回结果:
        //     一个 System.String 包含发出的请求的基本 URI System.Net.WebClient 或 System.String.Empty 如果尚未指定任何基址。
        //
        // 异常:
        //   T:System.ArgumentException:
        //     System.Net.WebClient.BaseAddress 设置为无效的 URI。 内部异常可能包含有助于您找到该错误的信息。
        public string BaseAddress { get; set; }
        //
        // 摘要:
        //     获取或设置用于进行身份验证请求并发送到主机的网络凭据。
        //
        // 返回结果:
        //     System.Net.ICredentials 包含请求的身份验证凭据。 默认值为 null。
        public ICredentials Credentials { get; set; }
        //
        // 摘要:
        //     获取或设置 System.Boolean 值,该值控制是否 System.Net.CredentialCache.DefaultCredentials 随请求一起发送。
        //
        // 返回结果:
        //     如果使用默认凭据,则为 true;否则为 false。 默认值为 false。
        public bool UseDefaultCredentials { get; set; }
        //
        // 摘要:
        //     获取或设置与请求关联的标头名称/值对的集合。
        //
        // 返回结果:
        //     一个 System.Net.WebHeaderCollection 包含与此请求关联的标头名称/值对。
        public WebHeaderCollection Headers { get; set; }
        //
        // 摘要:
        //     获取或设置与请求关联的查询名称/值对的集合。
        //
        // 返回结果:
        //     一个 System.Collections.Specialized.NameValueCollection ,其中包含与请求关联的查询名称/值对。 如果没有对与请求相关联,值为空
        //     System.Collections.Specialized.NameValueCollection。
        public NameValueCollection QueryString { get; set; }
        //
        // 摘要:
        //     获取与响应关联的标头名称/值对的集合。
        //
        // 返回结果:
        //     一个 System.Net.WebHeaderCollection 包含与响应关联的标头名称/值对或 null 如果收到没有响应。
        public WebHeaderCollection ResponseHeaders { get; }
        //
        // 摘要:
        //     获取或设置由此代理 System.Net.WebClient 对象。
        //
        // 返回结果:
        //     System.Net.IWebProxy 用于发送请求的实例。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     将 System.Net.WebClient.Proxy 设置为 null。
        public IWebProxy Proxy { get; set; }
        //
        // 摘要:
        //     获取或设置通过使用此 WebClient 实例获取的任何资源的应用程序的缓存策略 System.Net.WebRequest 对象。
        //
        // 返回结果:
        //     一个 System.Net.Cache.RequestCachePolicy 对象,表示应用程序的缓存要求。
        public RequestCachePolicy CachePolicy { get; set; }
        //
        // 摘要:
        //     获取指示正在进行中的 Web 请求。
        //
        // 返回结果:
        //     true 如果 Web 请求仍在进行;否则为 false。
        public bool IsBusy { get; }
        //
        // 摘要:
        //     获取或设置一个值,该值指示是否从 Internet 资源中读取的数据进行缓冲 System.Net.WebClient 实例。
        //
        // 返回结果:
        //     返回 System.Boolean。 如果为 true,则启用对从 Internet 资源接收的数据进行缓冲处理;如果为 false,则禁用缓冲处理。 默认值为
        //     true。
        [EditorBrowsable( EditorBrowsableState.Never )]
        [Obsolete( "This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true )]
        public bool AllowReadStreamBuffering { get; set; }

        //
        // 摘要:
        //     当一个异步操作以将数据写入到的资源使用写入流关闭时发生。
        [EditorBrowsable( EditorBrowsableState.Never )]
        [Obsolete( "This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true )]
        public event WriteStreamClosedEventHandler WriteStreamClosed;
        //
        // 摘要:
        //     若要打开包含资源的流的异步操作完成时发生。
        public event OpenReadCompletedEventHandler OpenReadCompleted;
        //
        // 摘要:
        //     若要打开一个流以将数据写入到资源的异步操作完成时发生。
        public event OpenWriteCompletedEventHandler OpenWriteCompleted;
        //
        // 摘要:
        //     当异步资源下载操作完成时发生。
        public event DownloadStringCompletedEventHandler DownloadStringCompleted;
        //
        // 摘要:
        //     当异步数据下载操作完成时发生。
        public event DownloadDataCompletedEventHandler DownloadDataCompleted;
        //
        // 摘要:
        //     异步文件下载操作完成时发生。
        public event AsyncCompletedEventHandler DownloadFileCompleted;
        //
        // 摘要:
        //     在异步字符串上载操作完成时发生。
        public event UploadStringCompletedEventHandler UploadStringCompleted;
        //
        // 摘要:
        //     在异步数据上载操作完成时发生。
        public event UploadDataCompletedEventHandler UploadDataCompleted;
        //
        // 摘要:
        //     异步文件上载操作完成时发生。
        public event UploadFileCompletedEventHandler UploadFileCompleted;
        //
        // 摘要:
        //     名称/值集合的异步上载完成时发生。
        public event UploadValuesCompletedEventHandler UploadValuesCompleted;
        //
        // 摘要:
        //     在异步下载操作成功转换部分或全部数据时发生。
        public event DownloadProgressChangedEventHandler DownloadProgressChanged;
        //
        // 摘要:
        //     在异步上载操作已成功转换部分或全部数据时发生。
        public event UploadProgressChangedEventHandler UploadProgressChanged;

        //
        // 摘要:
        //     取消一个挂起的异步操作。
        public void CancelAsync();
        //
        // 摘要:
        //     作为资源下载 System.Byte 数组中指定的 URI。
        //
        // 参数:
        //   address:
        //     从其下载数据 URI。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含已下载的资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载数据时出错。
        //
        //   T:System.NotSupportedException:
        //     该方法已在多个线程同时调用。
        public byte[] DownloadData( string address );
        //
        // 摘要:
        //     作为资源下载 System.Byte 数组中指定的 URI。
        //
        // 参数:
        //   address:
        //     所表示的 URI System.Uri 对象,便于从中下载数据。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含已下载的资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        public byte[] DownloadData( Uri address );
        //
        // 摘要:
        //     作为资源下载 System.Byte 数组,从异步操作的形式指定的 URI 数组。
        //
        // 参数:
        //   address:
        //     一个 System.Uri 包含要下载的 URI。
        //
        //   userToken:
        //     用户定义的对象传递给异步操作完成时调用的方法。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        public void DownloadDataAsync( Uri address, object userToken );
        //
        // 摘要:
        //     作为资源下载 System.Byte 数组,从异步操作的形式指定的 URI 数组。
        //
        // 参数:
        //   address:
        //     一个 System.Uri 包含要下载的 URI。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        public void DownloadDataAsync( Uri address );
        //
        // 摘要:
        //     作为资源下载 System.Byte 从 URI 指定为异步操作使用 task 对象的数组。
        //
        // 参数:
        //   address:
        //     要下载的资源的 URI。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已下载的资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        [ComVisible( false )]
        public Task<byte[]> DownloadDataTaskAsync( string address );
        //
        // 摘要:
        //     作为资源下载 System.Byte 从 URI 指定为异步操作使用 task 对象的数组。
        //
        // 参数:
        //   address:
        //     要下载的资源的 URI。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已下载的资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        [ComVisible( false )]
        public Task<byte[]> DownloadDataTaskAsync( Uri address );
        //
        // 摘要:
        //     用指定的 URI 的资源下载到本地文件。
        //
        // 参数:
        //   address:
        //     从其下载数据 URI。
        //
        //   fileName:
        //     若要接收的数据的本地文件的名称。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - filename 是 null
        //     或 System.String.Empty。 - 或 - 文件不存在。 -或者-下载数据时出错。
        //
        //   T:System.NotSupportedException:
        //     该方法已在多个线程同时调用。
        public void DownloadFile( string address, string fileName );
        //
        // 摘要:
        //     用指定的 URI 的资源下载到本地文件。
        //
        // 参数:
        //   address:
        //     URI 指定为 System.String, ,便于从中下载数据。
        //
        //   fileName:
        //     若要接收的数据的本地文件的名称。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - filename 是 null
        //     或 System.String.Empty。 - 或 - 文件不存在。 - 或 - 下载数据时出错。
        //
        //   T:System.NotSupportedException:
        //     该方法已在多个线程同时调用。
        public void DownloadFile( Uri address, string fileName );
        //
        // 摘要:
        //     对本地文件,下载将具有指定的 URI 的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要下载的资源的 URI。
        //
        //   fileName:
        //     要放置在本地计算机上的文件的名称。
        //
        //   userToken:
        //     用户定义的对象传递给异步操作完成时调用的方法。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        //
        //   T:System.InvalidOperationException:
        //     指定的本地文件 fileName 正由另一个线程使用。
        public void DownloadFileAsync( Uri address, string fileName, object userToken );
        //
        // 摘要:
        //     对本地文件,下载将具有指定的 URI 的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要下载的资源的 URI。
        //
        //   fileName:
        //     要放置在本地计算机上的文件的名称。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        //
        //   T:System.InvalidOperationException:
        //     指定的本地文件 fileName 正由另一个线程使用。
        public void DownloadFileAsync( Uri address, string fileName );
        //
        // 摘要:
        //     将指定的资源使用 task 对象的异步操作作为下载到本地文件。
        //
        // 参数:
        //   address:
        //     要下载的资源的 URI。
        //
        //   fileName:
        //     要放置在本地计算机上的文件的名称。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task。 表示异步操作的任务对象。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        //
        //   T:System.InvalidOperationException:
        //     指定的本地文件 fileName 正由另一个线程使用。
        [ComVisible( false )]
        public Task DownloadFileTaskAsync( string address, string fileName );
        //
        // 摘要:
        //     将指定的资源使用 task 对象的异步操作作为下载到本地文件。
        //
        // 参数:
        //   address:
        //     要下载的资源的 URI。
        //
        //   fileName:
        //     要放置在本地计算机上的文件的名称。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task。 表示异步操作的任务对象。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        //
        //   T:System.InvalidOperationException:
        //     指定的本地文件 fileName 正由另一个线程使用。
        [ComVisible( false )]
        public Task DownloadFileTaskAsync( Uri address, string fileName );
        //
        // 摘要:
        //     下载请求的资源作为 System.String。 要下载的资源指定为 System.Uri。
        //
        // 参数:
        //   address:
        //     一个 System.Uri 对象,其中包含要下载的 URI。
        //
        // 返回结果:
        //     一个 System.String 包含所请求的资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        //
        //   T:System.NotSupportedException:
        //     该方法已在多个线程同时调用。
        public string DownloadString( Uri address );
        //
        // 摘要:
        //     下载请求的资源作为 System.String。 要下载的资源指定为 System.String 其中包含的 URI。
        //
        // 参数:
        //   address:
        //     一个 System.String 包含要下载的 URI。
        //
        // 返回结果:
        //     一个 System.String 包含所请求的资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        //
        //   T:System.NotSupportedException:
        //     该方法已在多个线程同时调用。
        public string DownloadString( string address );
        //
        // 摘要:
        //     下载形式指定的资源 System.Uri。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     一个 System.Uri 包含要下载的 URI。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        public void DownloadStringAsync( Uri address );
        //
        // 摘要:
        //     将指定的字符串下载到指定的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     一个 System.Uri 包含要下载的 URI。
        //
        //   userToken:
        //     用户定义的对象传递给异步操作完成时调用的方法。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        public void DownloadStringAsync( Uri address, object userToken );
        //
        // 摘要:
        //     作为资源下载 System.String 从 URI 指定为使用 task 对象的异步操作。
        //
        // 参数:
        //   address:
        //     要下载的资源的 URI。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已下载的资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        [ComVisible( false )]
        public Task<string> DownloadStringTaskAsync( string address );
        //
        // 摘要:
        //     作为资源下载 System.String 从 URI 指定为使用 task 对象的异步操作。
        //
        // 参数:
        //   address:
        //     要下载的资源的 URI。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已下载的资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 下载资源时出错。
        [ComVisible( false )]
        public Task<string> DownloadStringTaskAsync( Uri address );
        //
        // 摘要:
        //     此时将打开具有指定为 URI 从资源下载数据的可读流 System.Uri
        //
        // 参数:
        //   address:
        //     URI 指定为 System.Uri 从中下载数据。
        //
        // 返回结果:
        //     一个 System.IO.Stream 用于从资源中读取数据。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,address 是无效的。 - 或 - 下载数据时出错。
        public Stream OpenRead( Uri address );
        //
        // 摘要:
        //     此时将打开具有指定为 URI 从资源下载数据的可读流 System.String。
        //
        // 参数:
        //   address:
        //     URI 指定为 System.String 从中下载数据。
        //
        // 返回结果:
        //     一个 System.IO.Stream 用于从资源中读取数据。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,address 是无效的。 - 或 - 下载数据时出错。
        public Stream OpenRead( string address );
        //
        // 摘要:
        //     将打开一个包含指定的资源的可读流。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要检索该资源的 URI。
        //
        //   userToken:
        //     用户定义的对象传递给异步操作完成时调用的方法。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和地址无效。 - 或 - 下载资源时出错。 - 或 - 打开的流时出错。
        public void OpenReadAsync( Uri address, object userToken );
        //
        // 摘要:
        //     将打开一个包含指定的资源的可读流。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要检索该资源的 URI。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和地址无效。 - 或 - 下载资源时出错。 - 或 - 打开的流时出错。
        public void OpenReadAsync( Uri address );
        //
        // 摘要:
        //     打开包含指定的资源作为异步操作使用 task 对象的可读流。
        //
        // 参数:
        //   address:
        //     要检索该资源的 URI。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.IO.Stream 用于从资源中读取数据。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和地址无效。 - 或 - 下载资源时出错。 - 或 - 打开的流时出错。
        [ComVisible( false )]
        public Task<Stream> OpenReadTaskAsync( string address );
        //
        // 摘要:
        //     打开包含指定的资源作为异步操作使用 task 对象的可读流。
        //
        // 参数:
        //   address:
        //     要检索该资源的 URI。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.IO.Stream 用于从资源中读取数据。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和地址无效。 - 或 - 下载资源时出错。 - 或 - 打开的流时出错。
        [ComVisible( false )]
        public Task<Stream> OpenReadTaskAsync( Uri address );
        //
        // 摘要:
        //     打开一个流以便将数据写入到指定的资源。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        // 返回结果:
        //     一个 System.IO.Stream 用于将数据写入到资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - 打开的流时出错。
        public Stream OpenWrite( string address );
        //
        // 摘要:
        //     打开一个流以便将数据写入到指定的资源,使用指定的方法。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        // 返回结果:
        //     一个 System.IO.Stream 用于将数据写入到资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - 打开的流时出错。
        public Stream OpenWrite( string address, string method );
        //
        // 摘要:
        //     打开一个流以便使用指定的方法将数据写入指定的资源。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        // 返回结果:
        //     一个 System.IO.Stream 用于将数据写入到资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - 打开的流时出错。
        public Stream OpenWrite( Uri address, string method );
        //
        // 摘要:
        //     打开一个流以便将数据写入到指定的资源。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        // 返回结果:
        //     一个 System.IO.Stream 用于将数据写入到资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - 打开的流时出错。
        public Stream OpenWrite( Uri address );
        //
        // 摘要:
        //     打开一个流以便将数据写入到指定的资源,使用指定的方法。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   userToken:
        //     用户定义对象,该对象传递给异步操作完成时调用的方法
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。
        public void OpenWriteAsync( Uri address, string method, object userToken );
        //
        // 摘要:
        //     打开一个流以便将数据写入到指定的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        public void OpenWriteAsync( Uri address );
        //
        // 摘要:
        //     打开一个流以便将数据写入到指定的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        public void OpenWriteAsync( Uri address, string method );
        //
        // 摘要:
        //     打开一个流以便以异步操作使用 task 对象的形式将数据写入指定的资源。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.IO.Stream 用于将数据写入到资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。
        [ComVisible( false )]
        public Task<Stream> OpenWriteTaskAsync( Uri address );
        //
        // 摘要:
        //     打开一个流以便以异步操作使用 task 对象的形式将数据写入指定的资源。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.IO.Stream 用于将数据写入到资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。
        [ComVisible( false )]
        public Task<Stream> OpenWriteTaskAsync( Uri address, string method );
        //
        // 摘要:
        //     打开一个流以便以异步操作使用 task 对象的形式将数据写入指定的资源。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.IO.Stream 用于将数据写入到资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。
        [ComVisible( false )]
        public Task<Stream> OpenWriteTaskAsync( string address );
        //
        // 摘要:
        //     打开一个流以便以异步操作使用 task 对象的形式将数据写入指定的资源。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.IO.Stream 用于将数据写入到资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。
        [ComVisible( false )]
        public Task<Stream> OpenWriteTaskAsync( string address, string method );
        //
        // 摘要:
        //     将数据缓冲区上载到指定的资源,使用指定的方法。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     要向资源发送的数据缓冲区。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - data 为 null。
        //     - 或 - 上载数据时出错。 - 或 - 没有来自主持该资源的服务器响应。
        public byte[] UploadData( Uri address, string method, byte[] data );
        //
        // 摘要:
        //     将数据缓冲区上载到指定的资源,使用指定的方法。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     要向资源发送的数据缓冲区。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - data 为 null。
        //     - 或 - 上载数据时出错。 - 或 - 没有来自主持该资源的服务器响应。
        public byte[] UploadData( string address, string method, byte[] data );
        //
        // 摘要:
        //     将数据缓冲区上载到由 URI 标识的资源。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   data:
        //     要向资源发送的数据缓冲区。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - data 为 null。
        //     - 或 - 发送数据时出错。 - 或 - 没有来自主持该资源的服务器响应。
        public byte[] UploadData( string address, byte[] data );
        //
        // 摘要:
        //     将数据缓冲区上载到由 URI 标识的资源。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   data:
        //     要向资源发送的数据缓冲区。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - data 为 null。
        //     - 或 - 发送数据时出错。 - 或 - 没有来自主持该资源的服务器响应。
        public byte[] UploadData( Uri address, byte[] data );
        //
        // 摘要:
        //     将数据缓冲区上载到由一个 URI,使用指定的方法和标识标记标识的资源。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果 null, ,默认情况下,开机自检 (http) 和 STOR ftp。
        //
        //   data:
        //     要向资源发送的数据缓冲区。
        //
        //   userToken:
        //     用户定义的对象传递给异步操作完成时调用的方法。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。 - 或
        //     - 没有来自主持该资源的服务器响应。
        public void UploadDataAsync( Uri address, string method, byte[] data, object userToken );
        //
        // 摘要:
        //     将数据缓冲区上载到由一个 URI,使用指定的方法标识的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果 null, ,默认情况下,开机自检 (http) 和 STOR ftp。
        //
        //   data:
        //     要向资源发送的数据缓冲区。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。 - 或
        //     - 没有来自主持该资源的服务器响应。
        public void UploadDataAsync( Uri address, string method, byte[] data );
        //
        // 摘要:
        //     将数据缓冲区上载到通过使用 POST 方法的 URI 标识的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   data:
        //     要向资源发送的数据缓冲区。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。 - 或
        //     - 没有来自主持该资源的服务器响应。
        public void UploadDataAsync( Uri address, byte[] data );
        //
        // 摘要:
        //     将数据缓冲区,其中包含上载 System.Byte 数组转换为异步操作使用 task 对象的形式指定的 URI。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果 null, ,默认情况下,开机自检 (http) 和 STOR ftp。
        //
        //   data:
        //     要向资源发送的数据缓冲区。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已上载的数据缓冲区时,从资源接收的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。 - 或
        //     - 没有来自主持该资源的服务器响应。
        [ComVisible( false )]
        public Task<byte[]> UploadDataTaskAsync( string address, string method, byte[] data );
        //
        // 摘要:
        //     将数据缓冲区,其中包含上载 System.Byte 数组转换为异步操作使用 task 对象的形式指定的 URI。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   data:
        //     要向资源发送的数据缓冲区。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已上载的数据缓冲区时,从资源接收的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。 - 或
        //     - 没有来自主持该资源的服务器响应。
        [ComVisible( false )]
        public Task<byte[]> UploadDataTaskAsync( Uri address, byte[] data );
        //
        // 摘要:
        //     将数据缓冲区,其中包含上载 System.Byte 数组转换为异步操作使用 task 对象的形式指定的 URI。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   data:
        //     要向资源发送的数据缓冲区。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已上载的数据缓冲区时,从资源接收的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。 - 或
        //     - 没有来自主持该资源的服务器响应。
        [ComVisible( false )]
        public Task<byte[]> UploadDataTaskAsync( string address, byte[] data );
        //
        // 摘要:
        //     将数据缓冲区,其中包含上载 System.Byte 数组转换为异步操作使用 task 对象的形式指定的 URI。
        //
        // 参数:
        //   address:
        //     要接收的数据资源的 URI。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果 null, ,默认情况下,开机自检 (http) 和 STOR ftp。
        //
        //   data:
        //     要向资源发送的数据缓冲区。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已上载的数据缓冲区时,从资源接收的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 打开的流时出错。 - 或
        //     - 没有来自主持该资源的服务器响应。
        [ComVisible( false )]
        public Task<byte[]> UploadDataTaskAsync( Uri address, string method, byte[] data );
        //
        // 摘要:
        //     将指定的本地文件上载到指定的资源,使用指定的方法。
        //
        // 参数:
        //   address:
        //     要接收的文件资源的 URI。
        //
        //   method:
        //     用于将文件发送到该资源的方法。 如果 null, ,默认情况下,开机自检 (http) 和 STOR ftp。
        //
        //   fileName:
        //     要发送到资源的文件。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - fileName 是
        //     null, ,是 System.String.Empty, 、 包含无效字符或不存在。 - 或 - 上载文件时出错。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - Content-type 标头开头 multipart。
        public byte[] UploadFile( Uri address, string method, string fileName );
        //
        // 摘要:
        //     将指定的本地文件上载到指定的资源,使用指定的方法。
        //
        // 参数:
        //   address:
        //     要接收的文件资源的 URI。
        //
        //   method:
        //     用于将文件发送到该资源的方法。 如果 null, ,默认情况下,开机自检 (http) 和 STOR ftp。
        //
        //   fileName:
        //     要发送到资源的文件。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - fileName 是
        //     null, ,是 System.String.Empty, 、 包含无效字符或不存在。 - 或 - 上载文件时出错。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - Content-type 标头开头 multipart。
        public byte[] UploadFile( string address, string method, string fileName );
        //
        // 摘要:
        //     将指定的本地文件上载到具有指定的 URI 的资源。
        //
        // 参数:
        //   address:
        //     要接收的文件资源的 URI。 例如,ftp://localhost/samplefile.txt。
        //
        //   fileName:
        //     要发送到资源的文件。 例如,"samplefile.txt"。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - fileName 是
        //     null, ,是 System.String.Empty, 、 包含无效字符或不存在。 - 或 - 上载文件时出错。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - Content-type 标头开头 multipart。
        public byte[] UploadFile( Uri address, string fileName );
        //
        // 摘要:
        //     将指定的本地文件上载到具有指定的 URI 的资源。
        //
        // 参数:
        //   address:
        //     要接收的文件资源的 URI。 例如,ftp://localhost/samplefile.txt。
        //
        //   fileName:
        //     要发送到资源的文件。 例如,"samplefile.txt"。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - fileName 是
        //     null, ,是 System.String.Empty, 、 包含无效字符或不存在。 - 或 - 上载文件时出错。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - Content-type 标头开头 multipart。
        public byte[] UploadFile( string address, string fileName );
        //
        // 摘要:
        //     将指定的本地文件上载到指定的资源使用 POST 方法。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收的文件资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果 null, ,默认情况下,开机自检 (http) 和 STOR ftp。
        //
        //   fileName:
        //     要发送到资源的文件。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - fileName 是 null,
        //     ,是 System.String.Empty, ,包含无效字符或该文件的指定的路径不存在。 - 或 - 打开的流时出错。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - Content-type 标头开头 multipart。
        public void UploadFileAsync( Uri address, string method, string fileName );
        //
        // 摘要:
        //     将指定的本地文件上载到指定的资源使用 POST 方法。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收的文件资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果 null, ,默认情况下,开机自检 (http) 和 STOR ftp。
        //
        //   fileName:
        //     要发送到资源的文件。
        //
        //   userToken:
        //     用户定义的对象传递给异步操作完成时调用的方法。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - fileName 是 null,
        //     ,是 System.String.Empty, ,包含无效字符或该文件的指定的路径不存在。 - 或 - 打开的流时出错。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - Content-type 标头开头 multipart。
        public void UploadFileAsync( Uri address, string method, string fileName, object userToken );
        //
        // 摘要:
        //     将指定的本地文件上载到指定的资源使用 POST 方法。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收的文件资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   fileName:
        //     要发送到资源的文件。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - fileName 是 null,
        //     ,是 System.String.Empty, ,包含无效字符或该文件的指定的路径不存在。 - 或 - 打开的流时出错。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - Content-type 标头开头 multipart。
        public void UploadFileAsync( Uri address, string fileName );
        //
        // 摘要:
        //     将指定的本地文件上载到资源,以异步操作使用的任务对象。
        //
        // 参数:
        //   address:
        //     要接收的文件资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   fileName:
        //     要发送到资源的本地文件。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已上载的文件时,从资源接收的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - fileName 是 null,
        //     ,是 System.String.Empty, ,包含无效字符或该文件的指定的路径不存在。 - 或 - 打开的流时出错。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - Content-type 标头开头 multipart。
        [ComVisible( false )]
        public Task<byte[]> UploadFileTaskAsync( string address, string fileName );
        //
        // 摘要:
        //     将指定的本地文件上载到资源,以异步操作使用的任务对象。
        //
        // 参数:
        //   address:
        //     要接收的文件资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   fileName:
        //     要发送到资源的本地文件。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已上载的文件时,从资源接收的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - fileName 是 null,
        //     ,是 System.String.Empty, ,包含无效字符或该文件的指定的路径不存在。 - 或 - 打开的流时出错。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - Content-type 标头开头 multipart。
        [ComVisible( false )]
        public Task<byte[]> UploadFileTaskAsync( Uri address, string fileName );
        //
        // 摘要:
        //     将指定的本地文件上载到资源,以异步操作使用的任务对象。
        //
        // 参数:
        //   address:
        //     要接收的文件资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果 null, ,默认情况下,开机自检 (http) 和 STOR ftp。
        //
        //   fileName:
        //     要发送到资源的本地文件。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已上载的文件时,从资源接收的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - fileName 是 null,
        //     ,是 System.String.Empty, ,包含无效字符或该文件的指定的路径不存在。 - 或 - 打开的流时出错。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - Content-type 标头开头 multipart。
        [ComVisible( false )]
        public Task<byte[]> UploadFileTaskAsync( string address, string method, string fileName );
        //
        // 摘要:
        //     将指定的本地文件上载到资源,以异步操作使用的任务对象。
        //
        // 参数:
        //   address:
        //     要接收的文件资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   method:
        //     用来将数据发送到该资源的方法。 如果 null, ,默认情况下,开机自检 (http) 和 STOR ftp。
        //
        //   fileName:
        //     要发送到资源的本地文件。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含已上载的文件时,从资源接收的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - fileName 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - fileName 是 null,
        //     ,是 System.String.Empty, ,包含无效字符或该文件的指定的路径不存在。 - 或 - 打开的流时出错。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - Content-type 标头开头 multipart。
        [ComVisible( false )]
        public Task<byte[]> UploadFileTaskAsync( Uri address, string method, string fileName );
        //
        // 摘要:
        //     将指定的字符串上载到指定的资源使用 POST 方法。
        //
        // 参数:
        //   address:
        //     要接收字符串资源的 URI。 有关 Http 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   data:
        //     要上载的字符串。
        //
        // 返回结果:
        //     一个 System.String 包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 没有来自主持该资源的服务器响应。
        public string UploadString( string address, string data );
        //
        // 摘要:
        //     将指定的字符串上载到指定的资源使用 POST 方法。
        //
        // 参数:
        //   address:
        //     要接收字符串资源的 URI。 有关 Http 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   data:
        //     要上载的字符串。
        //
        // 返回结果:
        //     一个 System.String 包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 没有来自主持该资源的服务器响应。
        public string UploadString( Uri address, string data );
        //
        // 摘要:
        //     将指定的字符串上载到指定的资源,使用指定的方法。
        //
        // 参数:
        //   address:
        //     要接收字符串资源的 URI。 此 URI 必须标识可以接受与发送的请求的资源 method 方法。
        //
        //   method:
        //     用来将字符串发送到资源的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     要上载的字符串。
        //
        // 返回结果:
        //     一个 System.String 包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - method 不能用于发送内容。
        public string UploadString( string address, string method, string data );
        //
        // 摘要:
        //     将指定的字符串上载到指定的资源,使用指定的方法。
        //
        // 参数:
        //   address:
        //     要接收字符串资源的 URI。 此 URI 必须标识可以接受与发送的请求的资源 method 方法。
        //
        //   method:
        //     用来将字符串发送到资源的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     要上载的字符串。
        //
        // 返回结果:
        //     一个 System.String 包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - method 不能用于发送内容。
        public string UploadString( Uri address, string method, string data );
        //
        // 摘要:
        //     将指定的字符串上载到指定的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收字符串资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   method:
        //     用于将文件发送到该资源的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     要上载的字符串。
        //
        //   userToken:
        //     用户定义的对象传递给异步操作完成时调用的方法。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - method 不能用于发送内容。
        //     - 或 - 没有来自主持该资源的服务器响应。
        public void UploadStringAsync( Uri address, string method, string data, object userToken );
        //
        // 摘要:
        //     将指定的字符串上载到指定的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收字符串资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   method:
        //     用于将文件发送到该资源的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     要上载的字符串。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - method 不能用于发送内容。
        //     - 或 - 没有来自主持该资源的服务器响应。
        public void UploadStringAsync( Uri address, string method, string data );
        //
        // 摘要:
        //     将指定的字符串上载到指定的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收字符串资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   data:
        //     要上载的字符串。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     data 为 null。
        //
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 没有来自主持该资源的服务器响应。
        public void UploadStringAsync( Uri address, string data );
        //
        // 摘要:
        //     将指定的字符串作为使用 task 对象的异步操作上载到指定的资源。
        //
        // 参数:
        //   address:
        //     要接收字符串资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   method:
        //     用于将文件发送到该资源的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     要上载的字符串。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.String 包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     data 为 null。
        //
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - method 不能用于发送内容。
        //     - 或 - 没有来自主持该资源的服务器响应。
        [ComVisible( false )]
        public Task<string> UploadStringTaskAsync( string address, string method, string data );
        //
        // 摘要:
        //     将指定的字符串作为使用 task 对象的异步操作上载到指定的资源。
        //
        // 参数:
        //   address:
        //     要接收字符串资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   method:
        //     用于将文件发送到该资源的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     要上载的字符串。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.String 包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     data 为 null。
        //
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - method 不能用于发送内容。
        //     - 或 - 没有来自主持该资源的服务器响应。
        [ComVisible( false )]
        public Task<string> UploadStringTaskAsync( Uri address, string method, string data );
        //
        // 摘要:
        //     将指定的字符串作为使用 task 对象的异步操作上载到指定的资源。
        //
        // 参数:
        //   address:
        //     要接收字符串资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   data:
        //     要上载的字符串。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.String 包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     data 为 null。
        //
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 没有来自主持该资源的服务器响应。
        [ComVisible( false )]
        public Task<string> UploadStringTaskAsync( string address, string data );
        //
        // 摘要:
        //     将指定的字符串作为使用 task 对象的异步操作上载到指定的资源。
        //
        // 参数:
        //   address:
        //     要接收字符串资源的 URI。 有关 HTTP 资源,此 URI 必须标识可以接受使用 POST 方法,如脚本或 ASP 页发送的请求的资源。
        //
        //   data:
        //     要上载的字符串。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.String 包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     data 为 null。
        //
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 没有来自主持该资源的服务器响应。
        [ComVisible( false )]
        public Task<string> UploadStringTaskAsync( Uri address, string data );
        //
        // 摘要:
        //     将指定的名称/值集合上载到由指定的 URI,使用指定的方法标识的资源。
        //
        // 参数:
        //   address:
        //     要接收该集合资源的 URI。
        //
        //   method:
        //     用于将文件发送到该资源的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     System.Collections.Specialized.NameValueCollection 将发送到资源。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - data 为 null。
        //     - 或 - 打开的流时出错。 - 或 - 没有来自主持该资源的服务器响应。 - 或 - Content-type 标头值不是 null 并且不是 application/x-www-form-urlencoded。
        public byte[] UploadValues( Uri address, string method, NameValueCollection data );
        //
        // 摘要:
        //     将指定的名称/值集合上载到由指定的 URI 标识的资源。
        //
        // 参数:
        //   address:
        //     要接收该集合资源的 URI。
        //
        //   data:
        //     System.Collections.Specialized.NameValueCollection 将发送到资源。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - data 为 null。
        //     - 或 - 没有来自主持该资源的服务器响应。 - 或 - 打开的流时出错。 - 或 - Content-type 标头不 null 或"应用程序/x-响应客户-­
        //     urlencoded"。
        public byte[] UploadValues( string address, NameValueCollection data );
        //
        // 摘要:
        //     将指定的名称/值集合上载到由指定的 URI,使用指定的方法标识的资源。
        //
        // 参数:
        //   address:
        //     要接收该集合资源的 URI。
        //
        //   method:
        //     用于将文件发送到该资源的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     System.Collections.Specialized.NameValueCollection 将发送到资源。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - data 为 null。
        //     - 或 - 打开的流时出错。 - 或 - 没有来自主持该资源的服务器响应。 - 或 - Content-type 标头值不是 null 并且不是 application/x-www-form-urlencoded。
        public byte[] UploadValues( string address, string method, NameValueCollection data );
        //
        // 摘要:
        //     将指定的名称/值集合上载到由指定的 URI 标识的资源。
        //
        // 参数:
        //   address:
        //     要接收该集合资源的 URI。
        //
        //   data:
        //     System.Collections.Specialized.NameValueCollection 将发送到资源。
        //
        // 返回结果:
        //     一个 System.Byte 数组,其中包含从资源的响应的正文。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - data 为 null。
        //     - 或 - 没有来自主持该资源的服务器响应。 - 或 - 打开的流时出错。 - 或 - Content-type 标头不 null 或"应用程序/x-响应客户-­
        //     urlencoded"。
        public byte[] UploadValues( Uri address, NameValueCollection data );
        //
        // 摘要:
        //     将指定的名称/值集合中的数据上载到由指定的 URI,使用指定的方法标识的资源。 此方法不会阻止调用线程,并允许调用方将对象传递给该操作完成时调用的方法。
        //
        // 参数:
        //   address:
        //     要接收该集合资源的 URI。 此 URI 必须标识可以接受与发送的请求的资源 method 方法。
        //
        //   method:
        //     用来将字符串发送到资源的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     System.Collections.Specialized.NameValueCollection 将发送到资源。
        //
        //   userToken:
        //     用户定义的对象传递给异步操作完成时调用的方法。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - method 不能用于发送内容。
        public void UploadValuesAsync( Uri address, string method, NameValueCollection data, object userToken );
        //
        // 摘要:
        //     将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收该集合资源的 URI。 此 URI 必须标识可以接受使用默认方法发送的请求的资源。 请参阅备注。
        //
        //   data:
        //     System.Collections.Specialized.NameValueCollection 将发送到资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 没有来自主持该资源的服务器响应。
        public void UploadValuesAsync( Uri address, NameValueCollection data );
        //
        // 摘要:
        //     将指定的名称/值集合中的数据上载到由指定的 URI,使用指定的方法标识的资源。 此方法不会阻止调用线程。
        //
        // 参数:
        //   address:
        //     要接收该集合资源的 URI。 此 URI 必须标识可以接受与发送的请求的资源 method 方法。
        //
        //   method:
        //     用来将字符串发送到资源的方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     System.Collections.Specialized.NameValueCollection 将发送到资源。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress 和 address 无效。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - method 不能用于发送内容。
        public void UploadValuesAsync( Uri address, string method, NameValueCollection data );
        //
        // 摘要:
        //     将指定的名称/值集合上载到由指定的 URI 作为异步操作使用 task 对象标识的资源。
        //
        // 参数:
        //   address:
        //     要接收该集合资源的 URI。
        //
        //   method:
        //     用来发送到资源的集合的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     System.Collections.Specialized.NameValueCollection 将发送到资源。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - method 不能用于发送内容。
        //     - 或 - 没有来自主持该资源的服务器响应。 - 或 - 打开的流时出错。 - 或 - Content-type 标头不 null 或"应用程序/x-响应客户-­
        //     urlencoded"。
        [ComVisible( false )]
        public Task<byte[]> UploadValuesTaskAsync( Uri address, string method, NameValueCollection data );
        //
        // 摘要:
        //     将指定的名称/值集合上载到由指定的 URI 作为异步操作使用 task 对象标识的资源。
        //
        // 参数:
        //   address:
        //     要接收该集合资源的 URI。
        //
        //   data:
        //     System.Collections.Specialized.NameValueCollection 将发送到资源。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - 打开的流时出错。 -
        //     或 - 没有来自主持该资源的服务器响应。 - 或 - Content-type 标头值不是 null 并且不是 application/x-www-form-urlencoded。
        [ComVisible( false )]
        public Task<byte[]> UploadValuesTaskAsync( Uri address, NameValueCollection data );
        //
        // 摘要:
        //     将指定的名称/值集合上载到由指定的 URI 作为异步操作使用 task 对象标识的资源。
        //
        // 参数:
        //   address:
        //     要接收该集合资源的 URI。
        //
        //   method:
        //     用来发送到资源的集合的 HTTP 方法。 如果为 null,默认值为 POST (http) 和 STOR ftp。
        //
        //   data:
        //     System.Collections.Specialized.NameValueCollection 将发送到资源。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - method 不能用于发送内容。
        //     - 或 - 没有来自主持该资源的服务器响应。 - 或 - 打开的流时出错。 - 或 - Content-type 标头不 null 或"应用程序/x-响应客户-­
        //     urlencoded"。
        [ComVisible( false )]
        public Task<byte[]> UploadValuesTaskAsync( string address, string method, NameValueCollection data );
        //
        // 摘要:
        //     将指定的名称/值集合上载到由指定的 URI 作为异步操作使用 task 对象标识的资源。
        //
        // 参数:
        //   address:
        //     要接收该集合资源的 URI。
        //
        //   data:
        //     System.Collections.Specialized.NameValueCollection 将发送到资源。
        //
        // 返回结果:
        //     返回 System.Threading.Tasks.Task`1。 表示异步操作的任务对象。 System.Threading.Tasks.Task`1.Result
        //     任务对象上的属性将返回 System.Byte 数组,其中包含由服务器发送的响应。
        //
        // 异常:
        //   T:System.ArgumentNullException:
        //     address 参数为 null。 - 或 - data 参数为 null。
        //
        //   T:System.Net.WebException:
        //     通过组合构成的 URI System.Net.WebClient.BaseAddress, ,和 address 无效。 - 或 - 没有来自主持该资源的服务器响应。
        //     - 或 - 打开的流时出错。 - 或 - Content-type 标头不 null 或"应用程序/x-响应客户-­ urlencoded"。
        [ComVisible( false )]
        public Task<byte[]> UploadValuesTaskAsync( string address, NameValueCollection data );
        //
        // 摘要:
        //     返回 System.Net.WebRequest 指定资源的对象。
        //
        // 参数:
        //   address:
        //     一个 System.Uri ,它标识要请求的资源。
        //
        // 返回结果:
        //     一个新 System.Net.WebRequest 指定资源的对象。
        protected virtual WebRequest GetWebRequest( Uri address );
        //
        // 摘要:
        //     返回指定 System.Net.WebResponse 的 System.Net.WebRequest。
        //
        // 参数:
        //   request:
        //     一个 System.Net.WebRequest 用于获得响应。
        //
        // 返回结果:
        //     一个 System.Net.WebResponse 包含指定的响应 System.Net.WebRequest。
        protected virtual WebResponse GetWebResponse( WebRequest request );
        //
        // 摘要:
        //     返回 System.Net.WebResponse 指定 System.Net.WebRequest 使用指定 System.IAsyncResult。
        //
        // 参数:
        //   request:
        //     一个 System.Net.WebRequest 用于获得响应。
        //
        //   result:
        //     System.IAsyncResult 对象获取的以前调用从 System.Net.WebRequest.BeginGetResponse(System.AsyncCallback,System.Object)
        ////
        // 返回结果:
        //     一个 System.Net.WebResponse 包含指定的响应 System.Net.WebRequest。
        protected virtual WebResponse GetWebResponse( WebRequest request, IAsyncResult result );
        //
        // 摘要:
        //     引发 System.Net.WebClient.DownloadDataCompleted 事件。
        //
        // 参数:
        //   e:
        //     一个 System.Net.DownloadDataCompletedEventArgs 对象,其中包含事件数据。
        protected virtual void OnDownloadDataCompleted( DownloadDataCompletedEventArgs e );
        //
        // 摘要:
        //     引发 System.Net.WebClient.DownloadFileCompleted 事件。
        //
        // 参数:
        //   e:
        //     System.ComponentModel.AsyncCompletedEventArgs 对象,其中包含事件数据。
        protected virtual void OnDownloadFileCompleted( AsyncCompletedEventArgs e );
        //
        // 摘要:
        //     引发 System.Net.WebClient.DownloadProgressChanged 事件。
        //
        // 参数:
        //   e:
        //     一个 System.Net.DownloadProgressChangedEventArgs 对象,其中包含事件数据。
        protected virtual void OnDownloadProgressChanged( DownloadProgressChangedEventArgs e );
        //
        // 摘要:
        //     引发 System.Net.WebClient.DownloadStringCompleted 事件。
        //
        // 参数:
        //   e:
        //     一个 System.Net.DownloadStringCompletedEventArgs 对象,其中包含事件数据。
        protected virtual void OnDownloadStringCompleted( DownloadStringCompletedEventArgs e );
        //
        // 摘要:
        //     引发 System.Net.WebClient.OpenReadCompleted 事件。
        //
        // 参数:
        //   e:
        //     一个 System.Net.OpenReadCompletedEventArgs 对象,其中包含事件数据。
        protected virtual void OnOpenReadCompleted( OpenReadCompletedEventArgs e );
        //
        // 摘要:
        //     引发 System.Net.WebClient.OpenWriteCompleted 事件。
        //
        // 参数:
        //   e:
        //     一个 System.Net.OpenWriteCompletedEventArgs 对象,其中包含事件数据。
        protected virtual void OnOpenWriteCompleted( OpenWriteCompletedEventArgs e );
        //
        // 摘要:
        //     引发 System.Net.WebClient.UploadDataCompleted 事件。
        //
        // 参数:
        //   e:
        //     一个 System.Net.UploadDataCompletedEventArgs 对象,其中包含事件数据。
        protected virtual void OnUploadDataCompleted( UploadDataCompletedEventArgs e );
        //
        // 摘要:
        //     引发 System.Net.WebClient.UploadFileCompleted 事件。
        //
        // 参数:
        //   e:
        //     System.Net.UploadFileCompletedEventArgs 对象,其中包含事件数据。
        protected virtual void OnUploadFileCompleted( UploadFileCompletedEventArgs e );
        //
        // 摘要:
        //     引发 System.Net.WebClient.UploadProgressChanged 事件。
        //
        // 参数:
        //   e:
        //     System.Net.UploadProgressChangedEventArgs 对象,其中包含事件数据。
        protected virtual void OnUploadProgressChanged( UploadProgressChangedEventArgs e );
        //
        // 摘要:
        //     引发 System.Net.WebClient.UploadStringCompleted 事件。
        //
        // 参数:
        //   e:
        //     System.Net.UploadStringCompletedEventArgs 对象,其中包含事件数据。
        protected virtual void OnUploadStringCompleted( UploadStringCompletedEventArgs e );
        //
        // 摘要:
        //     引发 System.Net.WebClient.UploadValuesCompleted 事件。
        //
        // 参数:
        //   e:
        //     一个 System.Net.UploadValuesCompletedEventArgs 对象,其中包含事件数据。
        protected virtual void OnUploadValuesCompleted( UploadValuesCompletedEventArgs e );
        //
        // 摘要:
        //     引发 System.Net.WebClient.WriteStreamClosed 事件。
        //
        // 参数:
        //   e:
        //     一个 System.Net.WriteStreamClosedEventArgs 对象,其中包含事件数据。
        [EditorBrowsable( EditorBrowsableState.Never )]
        [Obsolete( "This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true )]
        protected virtual void OnWriteStreamClosed( WriteStreamClosedEventArgs e );
    }
}
2、
2.返回顶部
 
3.返回顶部
 
4.返回顶部
 
5.返回顶部
1、
2、
 
6.返回顶部
 
warn作者:ylbtech
出处:http://ylbtech.cnblogs.com/
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。

转载于:https://www.cnblogs.com/storebook/p/11422858.html

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值