ylbtech-System.Net.WebClient.cs |
1.程序集 System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089返回顶部 |
1、
#region 程序集 System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 // C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0\System.dll #endregion using System.Collections.Specialized; using System.ComponentModel; using System.IO; using System.Net.Cache; using System.Runtime; using System.Runtime.InteropServices; using System.Text; namespace System.Net { // // 摘要: // 提供向 URI 标识的资源发送数据和从 URI 标识的资源接收数据的公共方法。 [ComVisible(true)] public class WebClient : Component { // // 摘要: // 初始化 System.Net.WebClient 类的新实例。 public WebClient(); // // 摘要: // 获取或设置 System.Net.WebClient 发出请求的基 URI。 // // 返回结果: // System.String,包含 System.Net.WebClient 请求的基 URI;如果尚未指定基地址,则为 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; } // // 摘要: // 获取和设置用于上载和下载字符串的 System.Text.Encoding。 // // 返回结果: // 用于对字符串进行编码的 System.Text.Encoding。此属性的默认值为 System.Text.Encoding.Default 返回的编码。 public Encoding Encoding { get; set; } // // 摘要: // 了解是否存在进行中的 Web 请求。 // // 返回结果: // 如果存在进行中的 Web 请求,则为 true;否则为 false。 public bool IsBusy { get; } // // 摘要: // 在打开流以将数据写入资源的异步操作完成时发生。 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 OpenReadCompletedEventHandler OpenReadCompleted; // // 摘要: // 在异步下载操作成功转换部分或全部数据后发生。 public event DownloadProgressChangedEventHandler DownloadProgressChanged; // // 摘要: // 在异步上载操作成功转换部分或全部数据后发生。 public event UploadProgressChangedEventHandler UploadProgressChanged; // // 摘要: // 取消一个挂起的异步操作。 public void CancelAsync(); // // 摘要: // 以 System.Byte 数组形式通过指定的 URI 下载资源。 // // 参数: // address: // 从中下载数据的 URI。 // // 返回结果: // 一个 System.Byte 数组,其中包含下载的资源。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载数据时发生错误。 // // T:System.NotSupportedException: // 该方法已在多个线程上同时调用。 public byte[] DownloadData(string address); // // 摘要: // 以 System.Byte 数组形式通过指定的 URI 下载资源。 // // 参数: // address: // 由 System.Uri 对象表示的 URI,将从中下载数据。 // // 返回结果: // 一个 System.Byte 数组,其中包含下载的资源。 public byte[] DownloadData(Uri address); // // 摘要: // 以 System.Byte 数组形式下载指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 包含要下载的 URI 的 System.Uri。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载资源时出现错误。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void DownloadDataAsync(Uri address); // // 摘要: // 以 System.Byte 数组形式下载指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 包含要下载的 URI 的 System.Uri。 // // userToken: // 一个用户定义对象,此对象将被传递给完成异步操作时所调用的方法。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载资源时出现错误。 public void DownloadDataAsync(Uri address, object userToken); // // 摘要: // 将具有指定 URI 的资源下载到本地文件。 // // 参数: // address: // 从中下载数据的 URI。 // // fileName: // 要接收数据的本地文件的名称。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -filename 为 null // 或 System.String.Empty。- 或 -文件不存在。- 或 - 下载数据时发生错误。 // // T:System.NotSupportedException: // 该方法已在多个线程上同时调用。 public void DownloadFile(string address, string fileName); // // 摘要: // 将具有指定 URI 的资源下载到本地文件。 // // 参数: // address: // 以 System.String 形式指定的 URI,将从中下载数据。 // // fileName: // 要接收数据的本地文件的名称。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -filename 为 null // 或 System.String.Empty。- 或 -文件不存在。 - 或 -下载数据时发生错误。 // // T:System.NotSupportedException: // 该方法已在多个线程上同时调用。 public void DownloadFile(Uri address, string fileName); // // 摘要: // 将具有指定 URI 的资源下载到本地文件。此方法不会阻止调用线程。 // // 参数: // address: // 要下载的资源的 URI。 // // fileName: // 要放在本地计算机上的文件的名称。 // // userToken: // 一个用户定义对象,此对象将被传递给完成异步操作时所调用的方法。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载资源时出现错误。 // // T:System.InvalidOperationException: // fileName 指定的本地文件正由另一个线程使用。 public void DownloadFileAsync(Uri address, string fileName, object userToken); // // 摘要: // 将具有指定 URI 的资源下载到本地文件。此方法不会阻止调用线程。 // // 参数: // address: // 要下载的资源的 URI。 // // fileName: // 要放在本地计算机上的文件的名称。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载资源时出现错误。 // // T:System.InvalidOperationException: // fileName 指定的本地文件正由另一个线程使用。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void DownloadFileAsync(Uri address, string fileName); // // 摘要: // 以 System.String 形式下载请求的资源。以包含 URI 的 System.String 的形式指定要下载的资源。 // // 参数: // address: // 包含要下载的 URI 的 System.String。 // // 返回结果: // 一个 System.String,其中包含请求的资源。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载资源时出现错误。 // // T:System.NotSupportedException: // 该方法已在多个线程上同时调用。 public string DownloadString(string address); // // 摘要: // 以 System.String 形式下载请求的资源。以 System.Uri 形式指定要下载的资源。 // // 参数: // address: // 一个 System.Uri 对象,其中包含要下载的 URI。 // // 返回结果: // 一个 System.String,其中包含请求的资源。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载资源时出现错误。 // // T:System.NotSupportedException: // 该方法已在多个线程上同时调用。 public string DownloadString(Uri address); // // 摘要: // 将指定的字符串下载到指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 包含要下载的 URI 的 System.Uri。 // // userToken: // 一个用户定义对象,此对象将被传递给完成异步操作时所调用的方法。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载资源时出现错误。 public void DownloadStringAsync(Uri address, object userToken); // // 摘要: // 下载以 System.Uri 形式指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 包含要下载的 URI 的 System.Uri。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载资源时出现错误。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void DownloadStringAsync(Uri address); // // 摘要: // 为从具有 System.String 指定的 URI 的资源下载的数据打开一个可读的流。 // // 参数: // address: // 以 System.String 形式指定的 URI,将从中下载数据。 // // 返回结果: // 一个 System.IO.Stream,用于从资源读取数据。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载数据时发生错误。 public Stream OpenRead(string address); // // 摘要: // 为从具有 System.Uri 指定的 URI 的资源下载的数据打开一个可读的流 // // 参数: // address: // 以 System.Uri 形式指定的 URI,将从中下载数据。 // // 返回结果: // 一个 System.IO.Stream,用于从资源读取数据。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载数据时发生错误。 public Stream OpenRead(Uri address); // // 摘要: // 打开包含指定资源的可读流。此方法不会阻止调用线程。 // // 参数: // address: // 要检索的资源的 URI。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载资源时出现错误。- // 或 -打开流时发生错误。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void OpenReadAsync(Uri address); // // 摘要: // 打开包含指定资源的可读流。此方法不会阻止调用线程。 // // 参数: // address: // 要检索的资源的 URI。 // // userToken: // 一个用户定义对象,此对象将被传递给完成异步操作时所调用的方法。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载资源时出现错误。- // 或 -打开流时发生错误。 public void OpenReadAsync(Uri address, object userToken); // // 摘要: // 打开一个流以将数据写入指定的资源。 // // 参数: // address: // 接收数据的资源的 URI。 // // 返回结果: // 用于将数据写入资源的 System.IO.Stream。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -打开流时发生错误。 public Stream OpenWrite(string address); // // 摘要: // 打开一个流以使用指定的方法向指定的资源写入数据。 // // 参数: // address: // 接收数据的资源的 URI。 // // method: // 用于将数据发送到资源的方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // 返回结果: // 用于将数据写入资源的 System.IO.Stream。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -打开流时发生错误。 public Stream OpenWrite(string address, string method); // // 摘要: // 打开一个流以使用指定的方法将数据写入指定的资源。 // // 参数: // address: // 接收数据的资源的 URI。 // // method: // 用于将数据发送到资源的方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // 返回结果: // 用于将数据写入资源的 System.IO.Stream。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -打开流时发生错误。 public Stream OpenWrite(Uri address, string method); // // 摘要: // 打开一个流以将数据写入指定的资源。 // // 参数: // address: // 接收数据的资源的 URI。 // // 返回结果: // 用于将数据写入资源的 System.IO.Stream。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -打开流时发生错误。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public Stream OpenWrite(Uri address); // // 摘要: // 打开一个流以将数据写入指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收数据的资源的 URI。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void OpenWriteAsync(Uri address); // // 摘要: // 打开一个流以使用指定的方法向指定的资源写入数据。此方法不会阻止调用线程。 // // 参数: // address: // 接收数据的资源的 URI。 // // method: // 用于将数据发送到资源的方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // userToken: // 一个用户定义对象,此对象将被传递给完成异步操作时所调用的方法 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -打开流时发生错误。 public void OpenWriteAsync(Uri address, string method, object userToken); // // 摘要: // 打开一个流以将数据写入指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收数据的资源的 URI。 // // method: // 用于将数据发送到资源的方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void OpenWriteAsync(Uri address, string method); // // 摘要: // 将数据缓冲区上载到由 URI 标识的资源。 // // 参数: // address: // 接收数据的资源的 URI。 // // data: // 要发送到资源的数据缓冲。 // // 返回结果: // 一个 System.Byte 数组,它包含来自资源的响应的正文。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -data 为 null。- // 或 -发送数据时出错。- 或 -承载资源的服务器没有响应。 public byte[] UploadData(string address, byte[] data); // // 摘要: // 使用指定的方法将数据缓冲区上载到指定资源。 // // 参数: // address: // 接收数据的资源的 URI。 // // method: // 用于将数据发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要发送到资源的数据缓冲。 // // 返回结果: // 一个 System.Byte 数组,它包含来自资源的响应的正文。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -data 为 null。- // 或 -上载数据时出错。- 或 -承载资源的服务器没有响应。 public byte[] UploadData(string address, string method, byte[] data); // // 摘要: // 使用指定的方法将数据缓冲区上载到指定资源。 // // 参数: // address: // 接收数据的资源的 URI。 // // method: // 用于将数据发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要发送到资源的数据缓冲。 // // 返回结果: // 一个 System.Byte 数组,它包含来自资源的响应的正文。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -data 为 null。- // 或 -上载数据时出错。- 或 -承载资源的服务器没有响应。 public byte[] UploadData(Uri address, string method, byte[] data); // // 摘要: // 将数据缓冲区上载到由 URI 标识的资源。 // // 参数: // address: // 接收数据的资源的 URI。 // // data: // 要发送到资源的数据缓冲。 // // 返回结果: // 一个 System.Byte 数组,它包含来自资源的响应的正文。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -data 为 null。- // 或 -发送数据时出错。- 或 -承载资源的服务器没有响应。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public byte[] UploadData(Uri address, byte[] data); // // 摘要: // 使用指定的方法和标识标记将数据缓冲区上载到由 URI 标识的资源。 // // 参数: // address: // 接收数据的资源的 URI。 // // method: // 用于将文件发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要发送到资源的数据缓冲。 // // userToken: // 一个用户定义对象,此对象将被传递给完成异步操作时所调用的方法。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -打开流时发生错误。- 或 // -承载资源的服务器没有响应。 public void UploadDataAsync(Uri address, string method, byte[] data, object userToken); // // 摘要: // 使用 POST 方法将数据缓冲区上载到由 URI 标识的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收数据的资源的 URI。 // // data: // 要发送到资源的数据缓冲。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -打开流时发生错误。- 或 // -承载资源的服务器没有响应。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void UploadDataAsync(Uri address, byte[] data); // // 摘要: // 使用指定的方法将数据缓冲区上载到由 URI 标识的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收数据的资源的 URI。 // // method: // 用于将文件发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要发送到资源的数据缓冲。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -打开流时发生错误。- 或 // -承载资源的服务器没有响应。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void UploadDataAsync(Uri address, string method, byte[] data); // // 摘要: // 使用指定的方法将指定的本地文件上载到指定的资源。 // // 参数: // address: // 接收文件的资源的 URI。 // // method: // 用于将文件发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // fileName: // 要发送到资源的文件。 // // 返回结果: // 一个 System.Byte 数组,它包含来自资源的响应的正文。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -fileName 为 null、为 // System.String.Empty、包含无效字符或者不存在。- 或 -上载文件时出错。- 或 -承载资源的服务器没有响应。- 或 -Content-type // 标头以 multipart 开头。 public byte[] UploadFile(string address, string method, string fileName); // // 摘要: // 使用指定的方法将指定的本地文件上载到指定的资源。 // // 参数: // address: // 接收文件的资源的 URI。 // // method: // 用于将文件发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // fileName: // 要发送到资源的文件。 // // 返回结果: // 一个 System.Byte 数组,它包含来自资源的响应的正文。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -fileName 为 null、为 // System.String.Empty、包含无效字符或者不存在。- 或 -上载文件时出错。- 或 -承载资源的服务器没有响应。- 或 -Content-type // 标头以 multipart 开头。 public byte[] UploadFile(Uri address, string method, string fileName); // // 摘要: // 将指定的本地文件上载到具有指定 URI 的资源。 // // 参数: // address: // 接收文件的资源的 URI。例如,ftp://localhost/samplefile.txt。 // // fileName: // 要发送到资源的文件。例如,“samplefile.txt”。 // // 返回结果: // 一个 System.Byte 数组,它包含来自资源的响应的正文。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -fileName 为 null、为 // System.String.Empty、包含无效字符或者不存在。- 或 -上载文件时出错。- 或 -承载资源的服务器没有响应。- 或 -Content-type // 标头以 multipart 开头。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public byte[] UploadFile(Uri address, string fileName); // // 摘要: // 将指定的本地文件上载到具有指定 URI 的资源。 // // 参数: // address: // 接收文件的资源的 URI。例如,ftp://localhost/samplefile.txt。 // // fileName: // 要发送到资源的文件。例如,“samplefile.txt”。 // // 返回结果: // 一个 System.Byte 数组,它包含来自资源的响应的正文。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -fileName 为 null、为 // System.String.Empty、包含无效字符或者不存在。- 或 -上载文件时出错。- 或 -承载资源的服务器没有响应。- 或 -Content-type // 标头以 multipart 开头。 public byte[] UploadFile(string address, string fileName); // // 摘要: // 使用 POST 方法将指定的本地文件上载到指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收文件的资源的 URI。对于 HTTP 资源,此 URI 必须标识可以接受用 POST 方法发送的请求的资源,如脚本或 ASP 页。 // // fileName: // 要发送到资源的文件。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -fileName 为 null、为 // System.String.Empty、包含无效字符或者指定的文件路径不存在。- 或 -打开流时发生错误。- 或 -承载资源的服务器没有响应。- 或 -Content-type // 标头以 multipart 开头。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void UploadFileAsync(Uri address, string fileName); // // 摘要: // 使用 POST 方法将指定的本地文件上载到指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收文件的资源的 URI。对于 HTTP 资源,此 URI 必须标识可以接受用 POST 方法发送的请求的资源,如脚本或 ASP 页。 // // method: // 用于将数据发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // fileName: // 要发送到资源的文件。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -fileName 为 null、为 // System.String.Empty、包含无效字符或者指定的文件路径不存在。- 或 -打开流时发生错误。- 或 -承载资源的服务器没有响应。- 或 -Content-type // 标头以 multipart 开头。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void UploadFileAsync(Uri address, string method, string fileName); // // 摘要: // 使用 POST 方法将指定的本地文件上载到指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收文件的资源的 URI。对于 HTTP 资源,此 URI 必须标识可以接受用 POST 方法发送的请求的资源,如脚本或 ASP 页。 // // method: // 用于将数据发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // fileName: // 要发送到资源的文件。 // // userToken: // 一个用户定义对象,此对象将被传递给完成异步操作时所调用的方法。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -fileName 为 null、为 // System.String.Empty、包含无效字符或者指定的文件路径不存在。- 或 -打开流时发生错误。- 或 -承载资源的服务器没有响应。- 或 -Content-type // 标头以 multipart 开头。 public void UploadFileAsync(Uri address, string method, string fileName, object userToken); // // 摘要: // 使用指定的方法将指定的字符串上载到指定的资源。 // // 参数: // address: // 接收文件的资源的 URI。此 URI 必须标识可以接受使用 method 方法发送的请求的资源。 // // method: // 用于将字符串发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要上载的字符串。 // // 返回结果: // 一个 System.String,包含服务器发送的响应。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -承载资源的服务器没有响应。- // 或 -method 不能用来发送内容。 public string UploadString(Uri address, string method, string data); // // 摘要: // 使用指定的方法将指定的字符串上载到指定的资源。 // // 参数: // address: // 接收文件的资源的 URI。此 URI 必须标识可以接受使用 method 方法发送的请求的资源。 // // method: // 用于将字符串发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要上载的字符串。 // // 返回结果: // 一个 System.String,包含服务器发送的响应。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -承载资源的服务器没有响应。- // 或 -method 不能用来发送内容。 public string UploadString(string address, string method, string data); // // 摘要: // 使用 POST 方法将指定的字符串上载到指定的资源。 // // 参数: // address: // 要接收字符串的资源的 URI。对于 HTTP 资源,此 URI 必须标识可以接受用 POST 方法发送的请求的资源,如脚本或 ASP 页。 // // data: // 要上载的字符串。 // // 返回结果: // 一个 System.String,包含服务器发送的响应。 // // 异常: // T:System.ArgumentNullException: // data 为 null。 // // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -承载资源的服务器没有响应。 public string UploadString(string address, string data); // // 摘要: // 使用 POST 方法将指定的字符串上载到指定的资源。 // // 参数: // address: // 要接收字符串的资源的 URI。对于 HTTP 资源,此 URI 必须标识可以接受用 POST 方法发送的请求的资源,如脚本或 ASP 页。 // // data: // 要上载的字符串。 // // 返回结果: // 一个 System.String,包含服务器发送的响应。 // // 异常: // T:System.ArgumentNullException: // data 为 null。 // // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -承载资源的服务器没有响应。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public string UploadString(Uri address, string data); // // 摘要: // 将指定的字符串上载到指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收文件的资源的 URI。对于 HTTP 资源,此 URI 必须标识可以接受用 POST 方法发送的请求的资源,如脚本或 ASP 页。 // // method: // 用于将文件发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要上载的字符串。 // // userToken: // 一个用户定义对象,此对象将被传递给完成异步操作时所调用的方法。 // // 异常: // T:System.ArgumentNullException: // data 为 null。 // // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -承载资源的服务器没有响应。 public void UploadStringAsync(Uri address, string method, string data, object userToken); // // 摘要: // 将指定的字符串上载到指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收文件的资源的 URI。对于 HTTP 资源,此 URI 必须标识可以接受用 POST 方法发送的请求的资源,如脚本或 ASP 页。 // // method: // 用于将文件发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要上载的字符串。 // // 异常: // T:System.ArgumentNullException: // data 为 null。 // // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -承载资源的服务器没有响应。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void UploadStringAsync(Uri address, string method, string data); // // 摘要: // 将指定的字符串上载到指定的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收文件的资源的 URI。对于 HTTP 资源,此 URI 必须标识可以接受用 POST 方法发送的请求的资源,如脚本或 ASP 页。 // // data: // 要上载的字符串。 // // 异常: // T:System.ArgumentNullException: // data 为 null。 // // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -承载资源的服务器没有响应。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void UploadStringAsync(Uri address, string data); // // 摘要: // 使用指定的方法将指定的名称/值集合上载到指定的 URI 所标识的资源。 // // 参数: // address: // 接收集合的资源的 URI。 // // method: // 用于将文件发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要发送到资源的 System.Collections.Specialized.NameValueCollection。 // // 返回结果: // 一个 System.Byte 数组,它包含来自资源的响应的正文。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -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.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -data 为 null。- // 或 -承载资源的服务器没有响应。- 或 -打开流时发生错误。- 或 -Content-type 标头不是 null 或“application/x-www-form-urlencoded”。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public byte[] UploadValues(Uri address, NameValueCollection data); // // 摘要: // 使用指定的方法将指定的名称/值集合上载到指定的 URI 所标识的资源。 // // 参数: // address: // 接收集合的资源的 URI。 // // method: // 用于将文件发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要发送到资源的 System.Collections.Specialized.NameValueCollection。 // // 返回结果: // 一个 System.Byte 数组,它包含来自资源的响应的正文。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -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.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -data 为 null。- // 或 -承载资源的服务器没有响应。- 或 -打开流时发生错误。- 或 -Content-type 标头不是 null 或“application/x-www-form-urlencoded”。 public byte[] UploadValues(string address, NameValueCollection data); // // 摘要: // 使用指定的方法将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收集合的资源的 URI。此 URI 必须标识可以接受使用 method 方法发送的请求的资源。 // // method: // 用于将字符串发送到资源的方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要发送到资源的 System.Collections.Specialized.NameValueCollection。 // // 异常: // T:System.ArgumentNullException: // data 为 null。- 或 -address 为 null。 // // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -承载资源的服务器没有响应。- // 或 -method 不能用来发送内容。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void UploadValuesAsync(Uri address, string method, NameValueCollection data); // // 摘要: // 将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。此方法不会阻止调用线程。 // // 参数: // address: // 接收集合的资源的 URI。此 URI 必须标识可以接受使用默认方法发送的请求的资源。请参见“备注”。 // // data: // 要发送到资源的 System.Collections.Specialized.NameValueCollection。 // // 异常: // T:System.ArgumentNullException: // data 为 null。 // // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -承载资源的服务器没有响应。 [TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")] public void UploadValuesAsync(Uri address, NameValueCollection data); // // 摘要: // 使用指定的方法将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。此方法不会阻止调用线程,并允许调用方将对象传递给操作完成时所调用的方法。 // // 参数: // address: // 接收集合的资源的 URI。此 URI 必须标识可以接受使用 method 方法发送的请求的资源。 // // method: // 用于将字符串发送到资源的 HTTP 方法。如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。 // // data: // 要发送到资源的 System.Collections.Specialized.NameValueCollection。 // // userToken: // 一个用户定义对象,此对象将被传递给完成异步操作时所调用的方法。 // // 异常: // T:System.ArgumentNullException: // data 为 null。- 或 -address 为 null。 // // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -承载资源的服务器没有响应。- // 或 -method 不能用来发送内容。 public void UploadValuesAsync(Uri address, string method, NameValueCollection data, object userToken); // // 摘要: // 为指定资源返回一个 System.Net.WebRequest 对象。 // // 参数: // address: // 一个 System.Uri,用于标识要请求的资源。 // // 返回结果: // 一个新的 System.Net.WebRequest 对象,用于指定的资源。 protected virtual WebRequest GetWebRequest(Uri address); // // 摘要: // 返回对指定 System.Net.WebRequest 的 System.Net.WebResponse。 // // 参数: // request: // 用于获取响应的 System.Net.WebRequest。 // // 返回结果: // System.Net.WebResponse 包含对指定 System.Net.WebRequest 的响应。 protected virtual WebResponse GetWebResponse(WebRequest request); // // 摘要: // 使用指定的 System.IAsyncResult 获取对指定 System.Net.WebRequest 的 System.Net.WebResponse。 // // 参数: // 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); } }
2、
2.返回顶部 |
3. 摘要返回顶部 |
1、
// // 摘要: // 以 System.Byte 数组形式通过指定的 URI 下载资源。 // // 参数: // address: // 从中下载数据的 URI。 // // 返回结果: // 一个 System.Byte 数组,其中包含下载的资源。 // // 异常: // T:System.Net.WebException: // 通过组合 System.Net.WebClient.BaseAddress 和 address 所构成的 URI 无效。- 或 -下载数据时发生错误。 // // T:System.NotSupportedException: // 该方法已在多个线程上同时调用。 public byte[] DownloadData(string address);
2、
4.返回顶部 |
5.返回顶部 |
6.返回顶部 |
![]() |
作者:ylbtech 出处:http://ylbtech.cnblogs.com/ 本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。 |