WebClient.DownloadDataTaskAsync 方法

参考

定义

命名空间:: System.Net

程序集:: System.Net.WebClient.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

使用任务对象从指定 URI 中将资源作为 Byte 数组下载以作为异步操作。这些方法不阻止调用线程。

重载

DownloadDataTaskAsync(String)	使用任务对象从指定 URI 中将资源作为 Byte 数组下载以作为异步操作。
DownloadDataTaskAsync(Uri)	使用任务对象从指定 URI 中将资源作为 Byte 数组下载以作为异步操作。

DownloadDataTaskAsync(String)

Source:: WebClient.cs

Source:: WebClient.cs

Source:: 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);

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

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

[<System.Runtime.InteropServices.ComVisible(false)>]
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 数组。

属性: ComVisibleAttribute

例外

ArgumentNullException

address 参数为 null。

WebException

通过组合 BaseAddress 和 address 所构成的 URI 无效。

- 或 -

下载资源时出现错误。

注解

此操作不会阻止。返回 Task<TResult> 的对象将在下载数据资源后完成。

此方法使用与参数中指定的 URI 方案关联的协议的默认方法检索指定的 address 资源。数据是使用从线程池自动分配的线程资源异步下载的。

BaseAddress如果属性不是空字符串 (“”) ，并且address不包含绝对 URI，address则必须是一个相对 URI，与 BaseAddress 组合以构成所请求数据的绝对 URI。 QueryString如果属性不是空字符串，则会将其追加到 address。

此方法使用 RETR 命令下载 FTP 资源。对于 HTTP 资源，使用 GET 方法。

备注

当你在应用程序中启用网络跟踪后，此成员将输出跟踪信息。有关详细信息，请参阅 .NET Framework 中的网络跟踪。

下面的代码示例从服务器请求数据，并显示返回的数据。它假定 remoteUri 包含所请求数据的有效 URI。

适用于

DownloadDataTaskAsync(Uri)

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs