WebClient.DownloadDataTaskAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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。
返回
表示异步操作的任务对象。 任务对象上的 Result 属性将返回包含下载的资源的 Byte 数组。
- 属性
例外
address
参数为 null
。
注解
此操作不会阻止。 返回 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
使用任务对象从指定 URI 中将资源作为 Byte 数组下载以作为异步操作。
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>
Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())
参数
- address
- Uri
要下载的资源的 URI。
返回
表示异步操作的任务对象。 任务对象上的 Result 属性将返回包含下载的资源的 Byte 数组。
- 属性
例外
address
参数为 null
。
注解
此操作不会阻止。 返回 Task<TResult> 的对象将在下载数据资源后完成。
此方法使用与 参数中指定的 URI 方案关联的协议的默认方法检索指定的 address
资源。 数据是使用从线程池自动分配的线程资源异步下载的。
BaseAddress如果属性不是空字符串 (“”) ,并且address
不包含绝对 URI,address
则必须是一个相对 URI,与 BaseAddress 组合以构成所请求数据的绝对 URI。 QueryString如果 属性不是空字符串,则会将其追加到 address
。
此方法使用 RETR 命令下载 FTP 资源。 对于 HTTP 资源,使用 GET 方法。
备注
当你在应用程序中启用网络跟踪后,此成员将输出跟踪信息。 有关详细信息,请参阅 .NET Framework 中的网络跟踪。
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈