WebClient.DownloadDataTaskAsync 方法

定义

命名空间:

System.Net

程序集:

System.Net.WebClient.dll

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

重载

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

DownloadDataTaskAsync(String)

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

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 无效。

-或-

下载资源时出错。

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

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

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

如果 BaseAddress 属性不是空字符串（“”）且 address 不包含绝对 URI，address 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求数据的绝对 URI。 如果 QueryString 属性不是空字符串，则会将其追加到 address。

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

注意

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

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

DownloadDataTaskAsync(Uri)

Source:

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 无效。

-或-

下载资源时出错。

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

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

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

如果 BaseAddress 属性不是空字符串（“”）且 address 不包含绝对 URI，address 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求数据的绝对 URI。 如果 QueryString 属性不是空字符串，则会将其追加到 address。

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

注意

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