zoukankan      html  css  js  c++  java
  • System.Net.WebClient.cs

    ylbtech-System.Net.WebClient.cs
    提供用于将数据发送到和接收来自通过 URI 确认的资源数据的常用方法
    1.返回顶部
    1、
    #region 程序集 System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
    // C:Program Files (x86)Reference AssembliesMicrosoftFramework.NETFrameworkv4.7System.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/
    本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。
  • 相关阅读:
    HTTP以及TCP协议
    分布式理论
    JAVA基础面试题
    JAVA基础面试题
    vue 中百度富文本初始化内容加载失败(编辑操作某列数据时,富文本中内容偶尔会为空)
    CodeMirror的使用方法
    JSON格式化,JSON.stringify()的用法
    promise与await的用法
    服务器端node.js
    数组扁平化
  • 原文地址:https://www.cnblogs.com/storebook/p/11422858.html
Copyright © 2011-2022 走看看