WebClient.DownloadDataAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

以非同步作業的方式，從指定的 URI 下載資源做為 Byte 陣列。 這些方法不會封鎖呼叫執行緒。

多載

DownloadDataAsync(Uri)	以非同步作業的方式，從指定的 URI 下載資源做為 Byte 陣列。
DownloadDataAsync(Uri, Object)	以非同步作業的方式，從指定的 URI 下載資源做為 Byte 陣列。

DownloadDataAsync(Uri)

來源:

WebClient.cs

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

例外狀況

ArgumentNullException

address 參數為 null。

WebException

合併 BaseAddress 和 address 而形成的 URI 是無效的。

-或-

下載資源時發生錯誤。

備註

這個方法會使用與 中指定的 addressURI 配置相關聯之通訊協議的預設方法，擷取指定的資源。 數據會使用從線程集區自動配置的線程資源，以異步方式下載數據。

這個方法不會在下載資源時封鎖呼叫線程。 若要在等候伺服器的回應時下載資源並封鎖，請使用其中 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)

來源:

WebClient.cs

以非同步作業的方式，從指定的 URI 下載資源做為 Byte 陣列。

public:
 void DownloadDataAsync(Uri ^ address, System::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

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

例外狀況

ArgumentNullException

address 參數為 null。

WebException

合併 BaseAddress 和 address 而形成的 URI 是無效的。

-或-

下載資源時發生錯誤。

備註

這個方法會使用與 中指定的 addressURI 配置相關聯之通訊協議的預設方法，擷取指定的資源。 數據會使用從線程集區自動配置的線程資源，以異步方式下載數據。

這個方法不會在下載資源時封鎖呼叫線程。 若要在等候伺服器的回應時下載資源並封鎖，請使用其中 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 中的網路追蹤。