.NETFramework：System.Net.WebClient.cs
生活随笔
收集整理的這篇文章主要介紹了
.NETFramework：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 Assemblies\Microsoft\Framework\.NETFramework\v4.7\System.dll
#endregion using System.Collections.Specialized;
using System.ComponentModel;
using System.IO;
using System.Net.Cache;
using System.Runtime.InteropServices;
using System.Text;
using System.Threading.Tasks; namespace System.Net
{
//
// 摘要:
// 提供用于將數據發送到和接收來自通過 URI 確認的資源數據的常用方法。
[ComVisible( true )]
public class WebClient : Component
{
//
// 摘要:
// 初始化 System.Net.WebClient 類的新實例。
public WebClient(); //
// 摘要:
// 獲取或設置一個值，該值指示是否緩沖數據寫入 Internet 資源的 System.Net.WebClient 實例。
//
// 返回結果:
// 返回 System.Boolean。 true 若要啟用對寫入 Internet 資源中; 的數據進行緩沖 false 禁用緩沖處理。 默認值為 true。
[EditorBrowsable( EditorBrowsableState.Never )]
[Obsolete( "This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true )]
public bool AllowWriteStreamBuffering { get; set; }
//
// 摘要:
// 獲取和設置 System.Text.Encoding 用于上載和下載字符串。
//
// 返回結果:
// 一個 System.Text.Encoding 用來對字符串進行編碼。 此屬性的默認值是由返回的編碼 System.Text.Encoding.Default。
public Encoding Encoding { get; set; }
//
// 摘要:
// 獲取或設置發出的請求的基 URI System.Net.WebClient。
//
// 返回結果:
// 一個 System.String 包含發出的請求的基本 URI System.Net.WebClient 或 System.String.Empty 如果尚未指定任何基址。
//
// 異常:
// T:System.ArgumentException:
// System.Net.WebClient.BaseAddress 設置為無效的 URI。 內部異常可能包含有助于您找到該錯誤的信息。
public string BaseAddress { get; set; }
//
// 摘要:
// 獲取或設置用于進行身份驗證請求并發送到主機的網絡憑據。
//
// 返回結果:
// System.Net.ICredentials 包含請求的身份驗證憑據。 默認值為 null。
public ICredentials Credentials { get; set; }
//
// 摘要:
// 獲取或設置 System.Boolean 值，該值控制是否 System.Net.CredentialCache.DefaultCredentials 隨請求一起發送。
//
// 返回結果:
// 如果使用默認憑據，則為 true；否則為 false。 默認值為 false。
public bool UseDefaultCredentials { get; set; }
//
// 摘要:
// 獲取或設置與請求關聯的標頭名稱/值對的集合。
//
// 返回結果:
// 一個 System.Net.WebHeaderCollection 包含與此請求關聯的標頭名稱/值對。
public WebHeaderCollection Headers { get; set; }
//
// 摘要:
// 獲取或設置與請求關聯的查詢名稱/值對的集合。
//
// 返回結果:
// 一個 System.Collections.Specialized.NameValueCollection ，其中包含與請求關聯的查詢名稱/值對。 如果沒有對與請求相關聯，值為空
// System.Collections.Specialized.NameValueCollection。
public NameValueCollection QueryString { get; set; }
//
// 摘要:
// 獲取與響應關聯的標頭名稱/值對的集合。
//
// 返回結果:
// 一個 System.Net.WebHeaderCollection 包含與響應關聯的標頭名稱/值對或 null 如果收到沒有響應。
public WebHeaderCollection ResponseHeaders { get; }
//
// 摘要:
// 獲取或設置由此代理 System.Net.WebClient 對象。
//
// 返回結果:
// System.Net.IWebProxy 用于發送請求的實例。
//
// 異常:
// T:System.ArgumentNullException:
// 將 System.Net.WebClient.Proxy 設置為 null。
public IWebProxy Proxy { get; set; }
//
// 摘要:
// 獲取或設置通過使用此 WebClient 實例獲取的任何資源的應用程序的緩存策略 System.Net.WebRequest 對象。
//
// 返回結果:
// 一個 System.Net.Cache.RequestCachePolicy 對象，表示應用程序的緩存要求。
public RequestCachePolicy CachePolicy { get; set; }
//
// 摘要:
// 獲取指示正在進行中的 Web 請求。
//
// 返回結果:
// true 如果 Web 請求仍在進行;否則為 false。
public bool IsBusy { get; }
//
// 摘要:
// 獲取或設置一個值，該值指示是否從 Internet 資源中讀取的數據進行緩沖 System.Net.WebClient 實例。
//
// 返回結果:
// 返回 System.Boolean。 如果為 true，則啟用對從 Internet 資源接收的數據進行緩沖處理；如果為 false，則禁用緩沖處理。 默認值為
// true。
[EditorBrowsable( EditorBrowsableState.Never )]
[Obsolete( "This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true )]
public bool AllowReadStreamBuffering { get; set; } //
// 摘要:
// 當一個異步操作以將數據寫入到的資源使用寫入流關閉時發生。
[EditorBrowsable( EditorBrowsableState.Never )]
[Obsolete( "This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true )]
public event WriteStreamClosedEventHandler WriteStreamClosed;
//
// 摘要:
// 若要打開包含資源的流的異步操作完成時發生。
public event OpenReadCompletedEventHandler OpenReadCompleted;
//
// 摘要:
// 若要打開一個流以將數據寫入到資源的異步操作完成時發生。
public event OpenWriteCompletedEventHandler OpenWriteCompleted;
//
// 摘要:
// 當異步資源下載操作完成時發生。
public event DownloadStringCompletedEventHandler DownloadStringCompleted;
//
// 摘要:
// 當異步數據下載操作完成時發生。
public event DownloadDataCompletedEventHandler DownloadDataCompleted;
//
// 摘要:
// 異步文件下載操作完成時發生。
public event AsyncCompletedEventHandler DownloadFileCompleted;
//
// 摘要:
// 在異步字符串上載操作完成時發生。
public event UploadStringCompletedEventHandler UploadStringCompleted;
//
// 摘要:
// 在異步數據上載操作完成時發生。
public event UploadDataCompletedEventHandler UploadDataCompleted;
//
// 摘要:
// 異步文件上載操作完成時發生。
public event UploadFileCompletedEventHandler UploadFileCompleted;
//
// 摘要:
// 名稱/值集合的異步上載完成時發生。
public event UploadValuesCompletedEventHandler UploadValuesCompleted;
//
// 摘要:
// 在異步下載操作成功轉換部分或全部數據時發生。
public event DownloadProgressChangedEventHandler DownloadProgressChanged;
//
// 摘要:
// 在異步上載操作已成功轉換部分或全部數據時發生。
public event UploadProgressChangedEventHandler UploadProgressChanged; //
// 摘要:
// 取消一個掛起的異步操作。
public void CancelAsync();
//
// 摘要:
// 作為資源下載 System.Byte 數組中指定的 URI。
//
// 參數:
// address:
// 從其下載數據 URI。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含已下載的資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載數據時出錯。
//
// T:System.NotSupportedException:
// 該方法已在多個線程同時調用。
public byte[] DownloadData( string address );
//
// 摘要:
// 作為資源下載 System.Byte 數組中指定的 URI。
//
// 參數:
// address:
// 所表示的 URI System.Uri 對象，便于從中下載數據。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含已下載的資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
public byte[] DownloadData( Uri address );
//
// 摘要:
// 作為資源下載 System.Byte 數組，從異步操作的形式指定的 URI 數組。
//
// 參數:
// address:
// 一個 System.Uri 包含要下載的 URI。
//
// userToken:
// 用戶定義的對象傳遞給異步操作完成時調用的方法。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
public void DownloadDataAsync( Uri address, object userToken );
//
// 摘要:
// 作為資源下載 System.Byte 數組，從異步操作的形式指定的 URI 數組。
//
// 參數:
// address:
// 一個 System.Uri 包含要下載的 URI。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
public void DownloadDataAsync( Uri address );
//
// 摘要:
// 作為資源下載 System.Byte 從 URI 指定為異步操作使用 task 對象的數組。
//
// 參數:
// address:
// 要下載的資源的 URI。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已下載的資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
[ComVisible( false )]
public Task<byte[]> DownloadDataTaskAsync( string address );
//
// 摘要:
// 作為資源下載 System.Byte 從 URI 指定為異步操作使用 task 對象的數組。
//
// 參數:
// address:
// 要下載的資源的 URI。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已下載的資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
[ComVisible( false )]
public Task<byte[]> DownloadDataTaskAsync( Uri address );
//
// 摘要:
// 用指定的 URI 的資源下載到本地文件。
//
// 參數:
// address:
// 從其下載數據 URI。
//
// fileName:
// 若要接收的數據的本地文件的名稱。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - filename 是 null
// 或 System.String.Empty。 - 或 - 文件不存在。 -或者-下載數據時出錯。
//
// T:System.NotSupportedException:
// 該方法已在多個線程同時調用。
public void DownloadFile( string address, string fileName );
//
// 摘要:
// 用指定的 URI 的資源下載到本地文件。
//
// 參數:
// address:
// URI 指定為 System.String, ，便于從中下載數據。
//
// fileName:
// 若要接收的數據的本地文件的名稱。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - filename 是 null
// 或 System.String.Empty。 - 或 - 文件不存在。 - 或 - 下載數據時出錯。
//
// T:System.NotSupportedException:
// 該方法已在多個線程同時調用。
public void DownloadFile( Uri address, string fileName );
//
// 摘要:
// 對本地文件，下載將具有指定的 URI 的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要下載的資源的 URI。
//
// fileName:
// 要放置在本地計算機上的文件的名稱。
//
// userToken:
// 用戶定義的對象傳遞給異步操作完成時調用的方法。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
//
// T:System.InvalidOperationException:
// 指定的本地文件 fileName 正由另一個線程使用。
public void DownloadFileAsync( Uri address, string fileName, object userToken );
//
// 摘要:
// 對本地文件，下載將具有指定的 URI 的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要下載的資源的 URI。
//
// fileName:
// 要放置在本地計算機上的文件的名稱。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
//
// T:System.InvalidOperationException:
// 指定的本地文件 fileName 正由另一個線程使用。
public void DownloadFileAsync( Uri address, string fileName );
//
// 摘要:
// 將指定的資源使用 task 對象的異步操作作為下載到本地文件。
//
// 參數:
// address:
// 要下載的資源的 URI。
//
// fileName:
// 要放置在本地計算機上的文件的名稱。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task。 表示異步操作的任務對象。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
//
// T:System.InvalidOperationException:
// 指定的本地文件 fileName 正由另一個線程使用。
[ComVisible( false )]
public Task DownloadFileTaskAsync( string address, string fileName );
//
// 摘要:
// 將指定的資源使用 task 對象的異步操作作為下載到本地文件。
//
// 參數:
// address:
// 要下載的資源的 URI。
//
// fileName:
// 要放置在本地計算機上的文件的名稱。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task。 表示異步操作的任務對象。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
//
// T:System.InvalidOperationException:
// 指定的本地文件 fileName 正由另一個線程使用。
[ComVisible( false )]
public Task DownloadFileTaskAsync( Uri address, string fileName );
//
// 摘要:
// 下載請求的資源作為 System.String。 要下載的資源指定為 System.Uri。
//
// 參數:
// address:
// 一個 System.Uri 對象，其中包含要下載的 URI。
//
// 返回結果:
// 一個 System.String 包含所請求的資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
//
// T:System.NotSupportedException:
// 該方法已在多個線程同時調用。
public string DownloadString( Uri address );
//
// 摘要:
// 下載請求的資源作為 System.String。 要下載的資源指定為 System.String 其中包含的 URI。
//
// 參數:
// address:
// 一個 System.String 包含要下載的 URI。
//
// 返回結果:
// 一個 System.String 包含所請求的資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
//
// T:System.NotSupportedException:
// 該方法已在多個線程同時調用。
public string DownloadString( string address );
//
// 摘要:
// 下載形式指定的資源 System.Uri。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 一個 System.Uri 包含要下載的 URI。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
public void DownloadStringAsync( Uri address );
//
// 摘要:
// 將指定的字符串下載到指定的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 一個 System.Uri 包含要下載的 URI。
//
// userToken:
// 用戶定義的對象傳遞給異步操作完成時調用的方法。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
public void DownloadStringAsync( Uri address, object userToken );
//
// 摘要:
// 作為資源下載 System.String 從 URI 指定為使用 task 對象的異步操作。
//
// 參數:
// address:
// 要下載的資源的 URI。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已下載的資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
[ComVisible( false )]
public Task<string> DownloadStringTaskAsync( string address );
//
// 摘要:
// 作為資源下載 System.String 從 URI 指定為使用 task 對象的異步操作。
//
// 參數:
// address:
// 要下載的資源的 URI。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已下載的資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 下載資源時出錯。
[ComVisible( false )]
public Task<string> DownloadStringTaskAsync( Uri address );
//
// 摘要:
// 此時將打開具有指定為 URI 從資源下載數據的可讀流 System.Uri
//
// 參數:
// address:
// URI 指定為 System.Uri 從中下載數據。
//
// 返回結果:
// 一個 System.IO.Stream 用于從資源中讀取數據。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，address 是無效的。 - 或 - 下載數據時出錯。
public Stream OpenRead( Uri address );
//
// 摘要:
// 此時將打開具有指定為 URI 從資源下載數據的可讀流 System.String。
//
// 參數:
// address:
// URI 指定為 System.String 從中下載數據。
//
// 返回結果:
// 一個 System.IO.Stream 用于從資源中讀取數據。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，address 是無效的。 - 或 - 下載數據時出錯。
public Stream OpenRead( string address );
//
// 摘要:
// 將打開一個包含指定的資源的可讀流。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要檢索該資源的 URI。
//
// userToken:
// 用戶定義的對象傳遞給異步操作完成時調用的方法。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和地址無效。 - 或 - 下載資源時出錯。 - 或 - 打開的流時出錯。
public void OpenReadAsync( Uri address, object userToken );
//
// 摘要:
// 將打開一個包含指定的資源的可讀流。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要檢索該資源的 URI。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和地址無效。 - 或 - 下載資源時出錯。 - 或 - 打開的流時出錯。
public void OpenReadAsync( Uri address );
//
// 摘要:
// 打開包含指定的資源作為異步操作使用 task 對象的可讀流。
//
// 參數:
// address:
// 要檢索該資源的 URI。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.IO.Stream 用于從資源中讀取數據。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和地址無效。 - 或 - 下載資源時出錯。 - 或 - 打開的流時出錯。
[ComVisible( false )]
public Task<Stream> OpenReadTaskAsync( string address );
//
// 摘要:
// 打開包含指定的資源作為異步操作使用 task 對象的可讀流。
//
// 參數:
// address:
// 要檢索該資源的 URI。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.IO.Stream 用于從資源中讀取數據。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和地址無效。 - 或 - 下載資源時出錯。 - 或 - 打開的流時出錯。
[ComVisible( false )]
public Task<Stream> OpenReadTaskAsync( Uri address );
//
// 摘要:
// 打開一個流以便將數據寫入到指定的資源。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// 返回結果:
// 一個 System.IO.Stream 用于將數據寫入到資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - 打開的流時出錯。
public Stream OpenWrite( string address );
//
// 摘要:
// 打開一個流以便將數據寫入到指定的資源，使用指定的方法。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// 返回結果:
// 一個 System.IO.Stream 用于將數據寫入到資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - 打開的流時出錯。
public Stream OpenWrite( string address, string method );
//
// 摘要:
// 打開一個流以便使用指定的方法將數據寫入指定的資源。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// 返回結果:
// 一個 System.IO.Stream 用于將數據寫入到資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - 打開的流時出錯。
public Stream OpenWrite( Uri address, string method );
//
// 摘要:
// 打開一個流以便將數據寫入到指定的資源。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// 返回結果:
// 一個 System.IO.Stream 用于將數據寫入到資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - 打開的流時出錯。
public Stream OpenWrite( Uri address );
//
// 摘要:
// 打開一個流以便將數據寫入到指定的資源，使用指定的方法。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// userToken:
// 用戶定義對象，該對象傳遞給異步操作完成時調用的方法
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。
public void OpenWriteAsync( Uri address, string method, object userToken );
//
// 摘要:
// 打開一個流以便將數據寫入到指定的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
public void OpenWriteAsync( Uri address );
//
// 摘要:
// 打開一個流以便將數據寫入到指定的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
public void OpenWriteAsync( Uri address, string method );
//
// 摘要:
// 打開一個流以便以異步操作使用 task 對象的形式將數據寫入指定的資源。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.IO.Stream 用于將數據寫入到資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。
[ComVisible( false )]
public Task<Stream> OpenWriteTaskAsync( Uri address );
//
// 摘要:
// 打開一個流以便以異步操作使用 task 對象的形式將數據寫入指定的資源。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.IO.Stream 用于將數據寫入到資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。
[ComVisible( false )]
public Task<Stream> OpenWriteTaskAsync( Uri address, string method );
//
// 摘要:
// 打開一個流以便以異步操作使用 task 對象的形式將數據寫入指定的資源。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.IO.Stream 用于將數據寫入到資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。
[ComVisible( false )]
public Task<Stream> OpenWriteTaskAsync( string address );
//
// 摘要:
// 打開一個流以便以異步操作使用 task 對象的形式將數據寫入指定的資源。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.IO.Stream 用于將數據寫入到資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。
[ComVisible( false )]
public Task<Stream> OpenWriteTaskAsync( string address, string method );
//
// 摘要:
// 將數據緩沖區上載到指定的資源，使用指定的方法。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// 要向資源發送的數據緩沖區。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - data 為 null。
// - 或 - 上載數據時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
public byte[] UploadData( Uri address, string method, byte[] data );
//
// 摘要:
// 將數據緩沖區上載到指定的資源，使用指定的方法。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// 要向資源發送的數據緩沖區。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - data 為 null。
// - 或 - 上載數據時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
public byte[] UploadData( string address, string method, byte[] data );
//
// 摘要:
// 將數據緩沖區上載到由 URI 標識的資源。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// data:
// 要向資源發送的數據緩沖區。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - data 為 null。
// - 或 - 發送數據時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
public byte[] UploadData( string address, byte[] data );
//
// 摘要:
// 將數據緩沖區上載到由 URI 標識的資源。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// data:
// 要向資源發送的數據緩沖區。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - data 為 null。
// - 或 - 發送數據時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
public byte[] UploadData( Uri address, byte[] data );
//
// 摘要:
// 將數據緩沖區上載到由一個 URI，使用指定的方法和標識標記標識的資源。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的方法。 如果 null, ，默認情況下，開機自檢 （http） 和 STOR ftp。
//
// data:
// 要向資源發送的數據緩沖區。
//
// userToken:
// 用戶定義的對象傳遞給異步操作完成時調用的方法。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。 - 或
// - 沒有來自主持該資源的服務器響應。
public void UploadDataAsync( Uri address, string method, byte[] data, object userToken );
//
// 摘要:
// 將數據緩沖區上載到由一個 URI，使用指定的方法標識的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的方法。 如果 null, ，默認情況下，開機自檢 （http） 和 STOR ftp。
//
// data:
// 要向資源發送的數據緩沖區。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。 - 或
// - 沒有來自主持該資源的服務器響應。
public void UploadDataAsync( Uri address, string method, byte[] data );
//
// 摘要:
// 將數據緩沖區上載到通過使用 POST 方法的 URI 標識的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// data:
// 要向資源發送的數據緩沖區。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。 - 或
// - 沒有來自主持該資源的服務器響應。
public void UploadDataAsync( Uri address, byte[] data );
//
// 摘要:
// 將數據緩沖區，其中包含上載 System.Byte 數組轉換為異步操作使用 task 對象的形式指定的 URI。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的方法。 如果 null, ，默認情況下，開機自檢 （http） 和 STOR ftp。
//
// data:
// 要向資源發送的數據緩沖區。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已上載的數據緩沖區時，從資源接收的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。 - 或
// - 沒有來自主持該資源的服務器響應。
[ComVisible( false )]
public Task<byte[]> UploadDataTaskAsync( string address, string method, byte[] data );
//
// 摘要:
// 將數據緩沖區，其中包含上載 System.Byte 數組轉換為異步操作使用 task 對象的形式指定的 URI。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// data:
// 要向資源發送的數據緩沖區。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已上載的數據緩沖區時，從資源接收的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。 - 或
// - 沒有來自主持該資源的服務器響應。
[ComVisible( false )]
public Task<byte[]> UploadDataTaskAsync( Uri address, byte[] data );
//
// 摘要:
// 將數據緩沖區，其中包含上載 System.Byte 數組轉換為異步操作使用 task 對象的形式指定的 URI。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// data:
// 要向資源發送的數據緩沖區。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已上載的數據緩沖區時，從資源接收的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。 - 或
// - 沒有來自主持該資源的服務器響應。
[ComVisible( false )]
public Task<byte[]> UploadDataTaskAsync( string address, byte[] data );
//
// 摘要:
// 將數據緩沖區，其中包含上載 System.Byte 數組轉換為異步操作使用 task 對象的形式指定的 URI。
//
// 參數:
// address:
// 要接收的數據資源的 URI。
//
// method:
// 用來將數據發送到該資源的方法。 如果 null, ，默認情況下，開機自檢 （http） 和 STOR ftp。
//
// data:
// 要向資源發送的數據緩沖區。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已上載的數據緩沖區時，從資源接收的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 打開的流時出錯。 - 或
// - 沒有來自主持該資源的服務器響應。
[ComVisible( false )]
public Task<byte[]> UploadDataTaskAsync( Uri address, string method, byte[] data );
//
// 摘要:
// 將指定的本地文件上載到指定的資源，使用指定的方法。
//
// 參數:
// address:
// 要接收的文件資源的 URI。
//
// method:
// 用于將文件發送到該資源的方法。 如果 null, ，默認情況下，開機自檢 （http） 和 STOR ftp。
//
// fileName:
// 要發送到資源的文件。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - fileName 是
// null, ，是 System.String.Empty, 、 包含無效字符或不存在。 - 或 - 上載文件時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - Content-type 標頭開頭 multipart。
public byte[] UploadFile( Uri address, string method, string fileName );
//
// 摘要:
// 將指定的本地文件上載到指定的資源，使用指定的方法。
//
// 參數:
// address:
// 要接收的文件資源的 URI。
//
// method:
// 用于將文件發送到該資源的方法。 如果 null, ，默認情況下，開機自檢 （http） 和 STOR ftp。
//
// fileName:
// 要發送到資源的文件。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - fileName 是
// null, ，是 System.String.Empty, 、 包含無效字符或不存在。 - 或 - 上載文件時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - Content-type 標頭開頭 multipart。
public byte[] UploadFile( string address, string method, string fileName );
//
// 摘要:
// 將指定的本地文件上載到具有指定的 URI 的資源。
//
// 參數:
// address:
// 要接收的文件資源的 URI。 例如，ftp://localhost/samplefile.txt。
//
// fileName:
// 要發送到資源的文件。 例如，"samplefile.txt"。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - fileName 是
// null, ，是 System.String.Empty, 、 包含無效字符或不存在。 - 或 - 上載文件時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - Content-type 標頭開頭 multipart。
public byte[] UploadFile( Uri address, string fileName );
//
// 摘要:
// 將指定的本地文件上載到具有指定的 URI 的資源。
//
// 參數:
// address:
// 要接收的文件資源的 URI。 例如，ftp://localhost/samplefile.txt。
//
// fileName:
// 要發送到資源的文件。 例如，"samplefile.txt"。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - fileName 是
// null, ，是 System.String.Empty, 、 包含無效字符或不存在。 - 或 - 上載文件時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - Content-type 標頭開頭 multipart。
public byte[] UploadFile( string address, string fileName );
//
// 摘要:
// 將指定的本地文件上載到指定的資源使用 POST 方法。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收的文件資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// method:
// 用來將數據發送到該資源的方法。 如果 null, ，默認情況下，開機自檢 （http） 和 STOR ftp。
//
// fileName:
// 要發送到資源的文件。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - fileName 是 null,
// ，是 System.String.Empty, ，包含無效字符或該文件的指定的路徑不存在。 - 或 - 打開的流時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - Content-type 標頭開頭 multipart。
public void UploadFileAsync( Uri address, string method, string fileName );
//
// 摘要:
// 將指定的本地文件上載到指定的資源使用 POST 方法。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收的文件資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// method:
// 用來將數據發送到該資源的方法。 如果 null, ，默認情況下，開機自檢 （http） 和 STOR ftp。
//
// fileName:
// 要發送到資源的文件。
//
// userToken:
// 用戶定義的對象傳遞給異步操作完成時調用的方法。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - fileName 是 null,
// ，是 System.String.Empty, ，包含無效字符或該文件的指定的路徑不存在。 - 或 - 打開的流時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - Content-type 標頭開頭 multipart。
public void UploadFileAsync( Uri address, string method, string fileName, object userToken );
//
// 摘要:
// 將指定的本地文件上載到指定的資源使用 POST 方法。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收的文件資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// fileName:
// 要發送到資源的文件。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - fileName 是 null,
// ，是 System.String.Empty, ，包含無效字符或該文件的指定的路徑不存在。 - 或 - 打開的流時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - Content-type 標頭開頭 multipart。
public void UploadFileAsync( Uri address, string fileName );
//
// 摘要:
// 將指定的本地文件上載到資源，以異步操作使用的任務對象。
//
// 參數:
// address:
// 要接收的文件資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// fileName:
// 要發送到資源的本地文件。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已上載的文件時，從資源接收的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - fileName 是 null,
// ，是 System.String.Empty, ，包含無效字符或該文件的指定的路徑不存在。 - 或 - 打開的流時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - Content-type 標頭開頭 multipart。
[ComVisible( false )]
public Task<byte[]> UploadFileTaskAsync( string address, string fileName );
//
// 摘要:
// 將指定的本地文件上載到資源，以異步操作使用的任務對象。
//
// 參數:
// address:
// 要接收的文件資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// fileName:
// 要發送到資源的本地文件。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已上載的文件時，從資源接收的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - fileName 是 null,
// ，是 System.String.Empty, ，包含無效字符或該文件的指定的路徑不存在。 - 或 - 打開的流時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - Content-type 標頭開頭 multipart。
[ComVisible( false )]
public Task<byte[]> UploadFileTaskAsync( Uri address, string fileName );
//
// 摘要:
// 將指定的本地文件上載到資源，以異步操作使用的任務對象。
//
// 參數:
// address:
// 要接收的文件資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// method:
// 用來將數據發送到該資源的方法。 如果 null, ，默認情況下，開機自檢 （http） 和 STOR ftp。
//
// fileName:
// 要發送到資源的本地文件。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已上載的文件時，從資源接收的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - fileName 是 null,
// ，是 System.String.Empty, ，包含無效字符或該文件的指定的路徑不存在。 - 或 - 打開的流時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - Content-type 標頭開頭 multipart。
[ComVisible( false )]
public Task<byte[]> UploadFileTaskAsync( string address, string method, string fileName );
//
// 摘要:
// 將指定的本地文件上載到資源，以異步操作使用的任務對象。
//
// 參數:
// address:
// 要接收的文件資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// method:
// 用來將數據發送到該資源的方法。 如果 null, ，默認情況下，開機自檢 （http） 和 STOR ftp。
//
// fileName:
// 要發送到資源的本地文件。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含已上載的文件時，從資源接收的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - fileName 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - fileName 是 null,
// ，是 System.String.Empty, ，包含無效字符或該文件的指定的路徑不存在。 - 或 - 打開的流時出錯。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - Content-type 標頭開頭 multipart。
[ComVisible( false )]
public Task<byte[]> UploadFileTaskAsync( Uri address, string method, string fileName );
//
// 摘要:
// 將指定的字符串上載到指定的資源使用 POST 方法。
//
// 參數:
// address:
// 要接收字符串資源的 URI。 有關 Http 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// data:
// 要上載的字符串。
//
// 返回結果:
// 一個 System.String 包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 沒有來自主持該資源的服務器響應。
public string UploadString( string address, string data );
//
// 摘要:
// 將指定的字符串上載到指定的資源使用 POST 方法。
//
// 參數:
// address:
// 要接收字符串資源的 URI。 有關 Http 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// data:
// 要上載的字符串。
//
// 返回結果:
// 一個 System.String 包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 沒有來自主持該資源的服務器響應。
public string UploadString( Uri address, string data );
//
// 摘要:
// 將指定的字符串上載到指定的資源，使用指定的方法。
//
// 參數:
// address:
// 要接收字符串資源的 URI。 此 URI 必須標識可以接受與發送的請求的資源 method 方法。
//
// method:
// 用來將字符串發送到資源的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// 要上載的字符串。
//
// 返回結果:
// 一個 System.String 包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - method 不能用于發送內容。
public string UploadString( string address, string method, string data );
//
// 摘要:
// 將指定的字符串上載到指定的資源，使用指定的方法。
//
// 參數:
// address:
// 要接收字符串資源的 URI。 此 URI 必須標識可以接受與發送的請求的資源 method 方法。
//
// method:
// 用來將字符串發送到資源的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// 要上載的字符串。
//
// 返回結果:
// 一個 System.String 包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - method 不能用于發送內容。
public string UploadString( Uri address, string method, string data );
//
// 摘要:
// 將指定的字符串上載到指定的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收字符串資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// method:
// 用于將文件發送到該資源的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// 要上載的字符串。
//
// userToken:
// 用戶定義的對象傳遞給異步操作完成時調用的方法。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - method 不能用于發送內容。
// - 或 - 沒有來自主持該資源的服務器響應。
public void UploadStringAsync( Uri address, string method, string data, object userToken );
//
// 摘要:
// 將指定的字符串上載到指定的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收字符串資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// method:
// 用于將文件發送到該資源的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// 要上載的字符串。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - method 不能用于發送內容。
// - 或 - 沒有來自主持該資源的服務器響應。
public void UploadStringAsync( Uri address, string method, string data );
//
// 摘要:
// 將指定的字符串上載到指定的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收字符串資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// data:
// 要上載的字符串。
//
// 異常:
// T:System.ArgumentNullException:
// data 為 null。
//
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 沒有來自主持該資源的服務器響應。
public void UploadStringAsync( Uri address, string data );
//
// 摘要:
// 將指定的字符串作為使用 task 對象的異步操作上載到指定的資源。
//
// 參數:
// address:
// 要接收字符串資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// method:
// 用于將文件發送到該資源的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// 要上載的字符串。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.String 包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// data 為 null。
//
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - method 不能用于發送內容。
// - 或 - 沒有來自主持該資源的服務器響應。
[ComVisible( false )]
public Task<string> UploadStringTaskAsync( string address, string method, string data );
//
// 摘要:
// 將指定的字符串作為使用 task 對象的異步操作上載到指定的資源。
//
// 參數:
// address:
// 要接收字符串資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// method:
// 用于將文件發送到該資源的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// 要上載的字符串。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.String 包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// data 為 null。
//
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - method 不能用于發送內容。
// - 或 - 沒有來自主持該資源的服務器響應。
[ComVisible( false )]
public Task<string> UploadStringTaskAsync( Uri address, string method, string data );
//
// 摘要:
// 將指定的字符串作為使用 task 對象的異步操作上載到指定的資源。
//
// 參數:
// address:
// 要接收字符串資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// data:
// 要上載的字符串。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.String 包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// data 為 null。
//
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 沒有來自主持該資源的服務器響應。
[ComVisible( false )]
public Task<string> UploadStringTaskAsync( string address, string data );
//
// 摘要:
// 將指定的字符串作為使用 task 對象的異步操作上載到指定的資源。
//
// 參數:
// address:
// 要接收字符串資源的 URI。 有關 HTTP 資源，此 URI 必須標識可以接受使用 POST 方法，如腳本或 ASP 頁發送的請求的資源。
//
// data:
// 要上載的字符串。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.String 包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// data 為 null。
//
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 沒有來自主持該資源的服務器響應。
[ComVisible( false )]
public Task<string> UploadStringTaskAsync( Uri address, string data );
//
// 摘要:
// 將指定的名稱/值集合上載到由指定的 URI，使用指定的方法標識的資源。
//
// 參數:
// address:
// 要接收該集合資源的 URI。
//
// method:
// 用于將文件發送到該資源的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// System.Collections.Specialized.NameValueCollection 將發送到資源。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - data 為 null。
// - 或 - 打開的流時出錯。 - 或 - 沒有來自主持該資源的服務器響應。 - 或 - Content-type 標頭值不是 null 并且不是 application/x-www-form-urlencoded。
public byte[] UploadValues( Uri address, string method, NameValueCollection data );
//
// 摘要:
// 將指定的名稱/值集合上載到由指定的 URI 標識的資源。
//
// 參數:
// address:
// 要接收該集合資源的 URI。
//
// data:
// System.Collections.Specialized.NameValueCollection 將發送到資源。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - data 為 null。
// - 或 - 沒有來自主持該資源的服務器響應。 - 或 - 打開的流時出錯。 - 或 - Content-type 標頭不 null 或"應用程序/x-響應客戶-
// urlencoded"。
public byte[] UploadValues( string address, NameValueCollection data );
//
// 摘要:
// 將指定的名稱/值集合上載到由指定的 URI，使用指定的方法標識的資源。
//
// 參數:
// address:
// 要接收該集合資源的 URI。
//
// method:
// 用于將文件發送到該資源的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// System.Collections.Specialized.NameValueCollection 將發送到資源。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - data 為 null。
// - 或 - 打開的流時出錯。 - 或 - 沒有來自主持該資源的服務器響應。 - 或 - Content-type 標頭值不是 null 并且不是 application/x-www-form-urlencoded。
public byte[] UploadValues( string address, string method, NameValueCollection data );
//
// 摘要:
// 將指定的名稱/值集合上載到由指定的 URI 標識的資源。
//
// 參數:
// address:
// 要接收該集合資源的 URI。
//
// data:
// System.Collections.Specialized.NameValueCollection 將發送到資源。
//
// 返回結果:
// 一個 System.Byte 數組，其中包含從資源的響應的正文。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - data 為 null。
// - 或 - 沒有來自主持該資源的服務器響應。 - 或 - 打開的流時出錯。 - 或 - Content-type 標頭不 null 或"應用程序/x-響應客戶-
// urlencoded"。
public byte[] UploadValues( Uri address, NameValueCollection data );
//
// 摘要:
// 將指定的名稱/值集合中的數據上載到由指定的 URI，使用指定的方法標識的資源。 此方法不會阻止調用線程，并允許調用方將對象傳遞給該操作完成時調用的方法。
//
// 參數:
// address:
// 要接收該集合資源的 URI。 此 URI 必須標識可以接受與發送的請求的資源 method 方法。
//
// method:
// 用來將字符串發送到資源的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// System.Collections.Specialized.NameValueCollection 將發送到資源。
//
// userToken:
// 用戶定義的對象傳遞給異步操作完成時調用的方法。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - method 不能用于發送內容。
public void UploadValuesAsync( Uri address, string method, NameValueCollection data, object userToken );
//
// 摘要:
// 將指定的名稱/值集合中的數據上載到由指定的 URI 標識的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收該集合資源的 URI。 此 URI 必須標識可以接受使用默認方法發送的請求的資源。 請參閱備注。
//
// data:
// System.Collections.Specialized.NameValueCollection 將發送到資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 沒有來自主持該資源的服務器響應。
public void UploadValuesAsync( Uri address, NameValueCollection data );
//
// 摘要:
// 將指定的名稱/值集合中的數據上載到由指定的 URI，使用指定的方法標識的資源。 此方法不會阻止調用線程。
//
// 參數:
// address:
// 要接收該集合資源的 URI。 此 URI 必須標識可以接受與發送的請求的資源 method 方法。
//
// method:
// 用來將字符串發送到資源的方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// System.Collections.Specialized.NameValueCollection 將發送到資源。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress 和 address 無效。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - method 不能用于發送內容。
public void UploadValuesAsync( Uri address, string method, NameValueCollection data );
//
// 摘要:
// 將指定的名稱/值集合上載到由指定的 URI 作為異步操作使用 task 對象標識的資源。
//
// 參數:
// address:
// 要接收該集合資源的 URI。
//
// method:
// 用來發送到資源的集合的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// System.Collections.Specialized.NameValueCollection 將發送到資源。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - method 不能用于發送內容。
// - 或 - 沒有來自主持該資源的服務器響應。 - 或 - 打開的流時出錯。 - 或 - Content-type 標頭不 null 或"應用程序/x-響應客戶-
// urlencoded"。
[ComVisible( false )]
public Task<byte[]> UploadValuesTaskAsync( Uri address, string method, NameValueCollection data );
//
// 摘要:
// 將指定的名稱/值集合上載到由指定的 URI 作為異步操作使用 task 對象標識的資源。
//
// 參數:
// address:
// 要接收該集合資源的 URI。
//
// data:
// System.Collections.Specialized.NameValueCollection 將發送到資源。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - 打開的流時出錯。 -
// 或 - 沒有來自主持該資源的服務器響應。 - 或 - Content-type 標頭值不是 null 并且不是 application/x-www-form-urlencoded。
[ComVisible( false )]
public Task<byte[]> UploadValuesTaskAsync( Uri address, NameValueCollection data );
//
// 摘要:
// 將指定的名稱/值集合上載到由指定的 URI 作為異步操作使用 task 對象標識的資源。
//
// 參數:
// address:
// 要接收該集合資源的 URI。
//
// method:
// 用來發送到資源的集合的 HTTP 方法。 如果為 null，默認值為 POST （http） 和 STOR ftp。
//
// data:
// System.Collections.Specialized.NameValueCollection 將發送到資源。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - method 不能用于發送內容。
// - 或 - 沒有來自主持該資源的服務器響應。 - 或 - 打開的流時出錯。 - 或 - Content-type 標頭不 null 或"應用程序/x-響應客戶-
// urlencoded"。
[ComVisible( false )]
public Task<byte[]> UploadValuesTaskAsync( string address, string method, NameValueCollection data );
//
// 摘要:
// 將指定的名稱/值集合上載到由指定的 URI 作為異步操作使用 task 對象標識的資源。
//
// 參數:
// address:
// 要接收該集合資源的 URI。
//
// data:
// System.Collections.Specialized.NameValueCollection 將發送到資源。
//
// 返回結果:
// 返回 System.Threading.Tasks.Task`1。 表示異步操作的任務對象。 System.Threading.Tasks.Task`1.Result
// 任務對象上的屬性將返回 System.Byte 數組，其中包含由服務器發送的響應。
//
// 異常:
// T:System.ArgumentNullException:
// address 參數為 null。 - 或 - data 參數為 null。
//
// T:System.Net.WebException:
// 通過組合構成的 URI System.Net.WebClient.BaseAddress, ，和 address 無效。 - 或 - 沒有來自主持該資源的服務器響應。
// - 或 - 打開的流時出錯。 - 或 - Content-type 標頭不 null 或"應用程序/x-響應客戶- urlencoded"。
[ComVisible( false )]
public Task<byte[]> UploadValuesTaskAsync( string address, NameValueCollection data );
//
// 摘要:
// 返回 System.Net.WebRequest 指定資源的對象。
//
// 參數:
// address:
// 一個 System.Uri ，它標識要請求的資源。
//
// 返回結果:
// 一個新 System.Net.WebRequest 指定資源的對象。
protected virtual WebRequest GetWebRequest( Uri address );
//
// 摘要:
// 返回指定 System.Net.WebResponse 的 System.Net.WebRequest。
//
// 參數:
// request:
// 一個 System.Net.WebRequest 用于獲得響應。
//
// 返回結果:
// 一個 System.Net.WebResponse 包含指定的響應 System.Net.WebRequest。
protected virtual WebResponse GetWebResponse( WebRequest request );
//
// 摘要:
// 返回 System.Net.WebResponse 指定 System.Net.WebRequest 使用指定 System.IAsyncResult。
//
// 參數:
// request:
// 一個 System.Net.WebRequest 用于獲得響應。
//
// result:
// System.IAsyncResult 對象獲取的以前調用從 System.Net.WebRequest.BeginGetResponse(System.AsyncCallback,System.Object)
// 。
//
// 返回結果:
// 一個 System.Net.WebResponse 包含指定的響應 System.Net.WebRequest。
protected virtual WebResponse GetWebResponse( WebRequest request, IAsyncResult result );
//
// 摘要:
// 引發 System.Net.WebClient.DownloadDataCompleted 事件。
//
// 參數:
// e:
// 一個 System.Net.DownloadDataCompletedEventArgs 對象，其中包含事件數據。
protected virtual void OnDownloadDataCompleted( DownloadDataCompletedEventArgs e );
//
// 摘要:
// 引發 System.Net.WebClient.DownloadFileCompleted 事件。
//
// 參數:
// e:
// System.ComponentModel.AsyncCompletedEventArgs 對象，其中包含事件數據。
protected virtual void OnDownloadFileCompleted( AsyncCompletedEventArgs e );
//
// 摘要:
// 引發 System.Net.WebClient.DownloadProgressChanged 事件。
//
// 參數:
// e:
// 一個 System.Net.DownloadProgressChangedEventArgs 對象，其中包含事件數據。
protected virtual void OnDownloadProgressChanged( DownloadProgressChangedEventArgs e );
//
// 摘要:
// 引發 System.Net.WebClient.DownloadStringCompleted 事件。
//
// 參數:
// e:
// 一個 System.Net.DownloadStringCompletedEventArgs 對象，其中包含事件數據。
protected virtual void OnDownloadStringCompleted( DownloadStringCompletedEventArgs e );
//
// 摘要:
// 引發 System.Net.WebClient.OpenReadCompleted 事件。
//
// 參數:
// e:
// 一個 System.Net.OpenReadCompletedEventArgs 對象，其中包含事件數據。
protected virtual void OnOpenReadCompleted( OpenReadCompletedEventArgs e );
//
// 摘要:
// 引發 System.Net.WebClient.OpenWriteCompleted 事件。
//
// 參數:
// e:
// 一個 System.Net.OpenWriteCompletedEventArgs 對象，其中包含事件數據。
protected virtual void OnOpenWriteCompleted( OpenWriteCompletedEventArgs e );
//
// 摘要:
// 引發 System.Net.WebClient.UploadDataCompleted 事件。
//
// 參數:
// e:
// 一個 System.Net.UploadDataCompletedEventArgs 對象，其中包含事件數據。
protected virtual void OnUploadDataCompleted( UploadDataCompletedEventArgs e );
//
// 摘要:
// 引發 System.Net.WebClient.UploadFileCompleted 事件。
//
// 參數:
// e:
// System.Net.UploadFileCompletedEventArgs 對象，其中包含事件數據。
protected virtual void OnUploadFileCompleted( UploadFileCompletedEventArgs e );
//
// 摘要:
// 引發 System.Net.WebClient.UploadProgressChanged 事件。
//
// 參數:
// e:
// System.Net.UploadProgressChangedEventArgs 對象，其中包含事件數據。
protected virtual void OnUploadProgressChanged( UploadProgressChangedEventArgs e );
//
// 摘要:
// 引發 System.Net.WebClient.UploadStringCompleted 事件。
//
// 參數:
// e:
// System.Net.UploadStringCompletedEventArgs 對象，其中包含事件數據。
protected virtual void OnUploadStringCompleted( UploadStringCompletedEventArgs e );
//
// 摘要:
// 引發 System.Net.WebClient.UploadValuesCompleted 事件。
//
// 參數:
// e:
// 一個 System.Net.UploadValuesCompletedEventArgs 對象，其中包含事件數據。
protected virtual void OnUploadValuesCompleted( UploadValuesCompletedEventArgs e );
//
// 摘要:
// 引發 System.Net.WebClient.WriteStreamClosed 事件。
//
// 參數:
// e:
// 一個 System.Net.WriteStreamClosedEventArgs 對象，其中包含事件數據。
[EditorBrowsable( EditorBrowsableState.Never )]
[Obsolete( "This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true )]
protected virtual void OnWriteStreamClosed( WriteStreamClosedEventArgs e );
}
}
2、
| 2.返回頂部 |
| 3.返回頂部 |
| 4.返回頂部 |
| 5.返回頂部 |
1、
https://docs.microsoft.com/en-us/dotnet/api/system.net.webclient?redirectedfrom=MSDN&view=netframework-4.8
2、
| 6.返回頂部 |
| 作者：ylbtech 出處：http://ylbtech.cnblogs.com/ 本文版權歸作者和博客園共有，歡迎轉載，但未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文連接，否則保留追究法律責任的權利。 |
總結
以上是生活随笔為你收集整理的.NETFramework：System.Net.WebClient.cs的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： SpringMVC起步
- 下一篇： QT判断文件/目录是否存在