WebClient.DownloadDataTaskAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

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

多載

DownloadDataTaskAsync(String)	使用工作物件，以非同步作業的方式，從指定的 URI 下載資源做為 Byte 陣列。
DownloadDataTaskAsync(Uri)	使用工作物件，以非同步作業的方式，從指定的 URI 下載資源做為 Byte 陣列。

DownloadDataTaskAsync(String)

來源:

WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);

member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>

Public Function DownloadDataTaskAsync (address As String) As Task(Of Byte())

參數

address

String

要下載之資源的 URI。

傳回

Task<Byte[]>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回包含已下載之資源的 Byte 陣列。

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

下載資源時發生錯誤。

備註

這項作業不會封鎖。 傳 Task<TResult> 回的物件會在下載資料資源之後完成。

這個方法會針對與 參數中指定的 address URI 配置相關聯的通訊協定，使用預設方法擷取指定的資源。 系統會使用從執行緒集區自動設定的執行緒資源，以非同步方式下載資料。

BaseAddress如果屬性不是空字串 (「」) 且 address 不包含絕對 URI， address 則必須是結合 BaseAddress 的相對 URI，才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串，則會附加至 address 。

此方法會使用 RETR 命令來下載 FTP 資源。 針對 HTTP 資源，會使用 GET 方法。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱.NET Framework 中的網路追蹤。

下列程式碼範例會向伺服器要求資料，並顯示傳回的資料。 它假設 remoteUri 包含所要求資料的有效 URI。

DownloadDataTaskAsync(Uri)

來源:

WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);

member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>

Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())

參數

address

Uri

要下載之資源的 URI。

傳回

Task<Byte[]>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回包含已下載之資源的 Byte 陣列。

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

下載資源時發生錯誤。

備註

這項作業不會封鎖。 傳 Task<TResult> 回的物件會在下載資料資源之後完成。

這個方法會針對與 參數中指定的 address URI 配置相關聯的通訊協定，使用預設方法擷取指定的資源。 系統會使用從執行緒集區自動設定的執行緒資源，以非同步方式下載資料。

BaseAddress如果屬性不是空字串 (「」) 且 address 不包含絕對 URI， address 則必須是結合 BaseAddress 的相對 URI，才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串，則會附加至 address 。

此方法會使用 RETR 命令來下載 FTP 資源。 針對 HTTP 資源，會使用 GET 方法。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱.NET Framework 中的網路追蹤。