WebClient.DownloadDataAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
以非同步作業的方式,從指定的 URI 下載資源做為 Byte 陣列。 這些方法不會封鎖呼叫執行緒。
多載
DownloadDataAsync(Uri) |
以非同步作業的方式,從指定的 URI 下載資源做為 Byte 陣列。 |
DownloadDataAsync(Uri, Object) |
以非同步作業的方式,從指定的 URI 下載資源做為 Byte 陣列。 |
DownloadDataAsync(Uri)
以非同步作業的方式,從指定的 URI 下載資源做為 Byte 陣列。
public:
void DownloadDataAsync(Uri ^ address);
public void DownloadDataAsync (Uri address);
member this.DownloadDataAsync : Uri -> unit
Public Sub DownloadDataAsync (address As Uri)
參數
例外狀況
address
參數為 null
。
備註
這個方法會使用與 中所 address
指定之 URI 配置相關聯之通訊協定的預設方法,擷取指定的資源。 系統會使用從執行緒集區自動設定的執行緒資源,以非同步方式下載資料。
此方法不會在下載資源時封鎖呼叫執行緒。 若要在等候伺服器的回應時下載資源並封鎖,請使用其中 DownloadData 一種方法。 下載完成時,會 DownloadDataCompleted 引發 事件。 您的應用程式必須處理此事件,才能接收通知。 下載的資料可在 屬性中使用 Result 。
在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 方法來取消尚未完成的 CancelAsync 非同步作業。
此方法會使用 RETR 命令來下載 FTP 資源。 針對 HTTP 資源,會使用 GET 方法。
BaseAddress如果屬性不是空字串 (「」) 且 address
不包含絕對 URI, address
則必須是結合 BaseAddress 的相對 URI,才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串,則會附加至 address
。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework 中的網路追蹤。
這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException 仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 DownloadData(Uri) 例外狀況。
適用於
DownloadDataAsync(Uri, Object)
以非同步作業的方式,從指定的 URI 下載資源做為 Byte 陣列。
public:
void DownloadDataAsync(Uri ^ address, System::Object ^ userToken);
public void DownloadDataAsync (Uri address, object? userToken);
public void DownloadDataAsync (Uri address, object userToken);
member this.DownloadDataAsync : Uri * obj -> unit
Public Sub DownloadDataAsync (address As Uri, userToken As Object)
參數
- userToken
- Object
使用者定義的物件,這個物件會在非同步作業完成時傳遞至叫用的方法。
例外狀況
address
參數為 null
。
備註
這個方法會使用與 中所 address
指定之 URI 配置相關聯之通訊協定的預設方法,擷取指定的資源。 系統會使用從執行緒集區自動設定的執行緒資源,以非同步方式下載資料。
此方法不會在下載資源時封鎖呼叫執行緒。 若要在等候伺服器的回應時下載資源並封鎖,請使用其中 DownloadData 一種方法。 下載完成時,會 DownloadDataCompleted 引發 事件。 您的應用程式必須處理此事件,才能接收通知。 下載的資料可在 屬性中使用 Result 。
在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 方法來取消尚未完成的 CancelAsync 非同步作業。
此方法會使用 RETR 命令來下載 FTP 資源。 針對 HTTP 資源,會使用 GET 方法。
BaseAddress如果屬性不是空字串 (「」) 且 address
不包含絕對 URI, address
則必須是結合 BaseAddress 的相對 URI,才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串,則會附加至 address
。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework 中的網路追蹤。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將推出:在 2024 年,我們將隨著內容的意見反應機制逐步淘汰 GitHub 問題,並以新的意見反應系統來取代。 如需詳細資訊,請參閱提交並檢視相關的意見反應