WebClient.DownloadDataAsync 方法

定义

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

重载

DownloadDataAsync(Uri)

从指定 URI 中将资源作为 Byte 数组下载以作为异步操作。

DownloadDataAsync(Uri, Object)

从指定 URI 中将资源作为 Byte 数组下载以作为异步操作。

DownloadDataAsync(Uri)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
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

例外

address 参数为 null

通过组合 BaseAddressaddress 所构成的 URI 无效。

- 或 -

下载资源时出现错误。

注解

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

下载资源时,此方法不会阻止调用线程。 若要下载资源并在等待服务器响应时阻止,请使用 方法之 DownloadData 一。 下载完成后,将 DownloadDataCompleted 引发 事件。 应用程序必须处理此事件才能接收通知。 下载的数据在 属性中 Result 可用。

在 .NET Framework 和 .NET Core 1.0 中,可以通过调用 方法来取消尚未完成的CancelAsync异步操作。

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

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

备注

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

此方法将存储在任务中,它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中,则在等待任务时将引发该异常。 使用异常(如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅 引发的 DownloadData(Uri)异常。

适用于

DownloadDataAsync(Uri, Object)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

从指定 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 无效。

- 或 -

下载资源时出现错误。

注解

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

下载资源时,此方法不会阻止调用线程。 若要下载资源并在等待服务器响应时阻止,请使用 方法之 DownloadData 一。 下载完成后,将 DownloadDataCompleted 引发 事件。 应用程序必须处理此事件才能接收通知。 下载的数据在 属性中 Result 可用。

在 .NET Framework 和 .NET Core 1.0 中,可以通过调用 方法来取消尚未完成的CancelAsync异步操作。

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

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

备注

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

适用于