WebClient.DownloadDataAsync 方法

定義

以非同步作業的方式,從指定的 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
Uri

Uri,包含要下載的 URI。

例外狀況

address 參數為 null

合併 BaseAddressaddress 而形成的 URI 是無效的。

-或-

下載資源時發生錯誤。

備註

這個方法會使用與 中所 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 中的網路追蹤

適用於

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)

參數

address
Uri

Uri,包含要下載的 URI。

userToken
Object

使用者定義的物件,這個物件會在非同步作業完成時傳遞至叫用的方法。

例外狀況

address 參數為 null

合併 BaseAddressaddress 而形成的 URI 是無效的。

-或-

下載資源時發生錯誤。

備註

這個方法會使用與 中所 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 中的網路追蹤

適用於