WebClient.DownloadFileAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将指定的资源作为异步操作下载到本地文件。 这些方法不会阻止调用线程。
重载
| 名称 | 说明 |
|---|---|
| DownloadFileAsync(Uri, String) |
将具有指定 URI 的资源下载到本地文件。 此方法不会阻止调用线程。 |
| DownloadFileAsync(Uri, String, Object) |
将具有指定 URI 的资源下载到本地文件。 此方法不会阻止调用线程。 |
DownloadFileAsync(Uri, String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
将具有指定 URI 的资源下载到本地文件。 此方法不会阻止调用线程。
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName);public void DownloadFileAsync(Uri address, string fileName);member this.DownloadFileAsync : Uri * string -> unitPublic Sub DownloadFileAsync (address As Uri, fileName As String)参数
- address
- Uri
要下载的资源的 URI。
- fileName
- String
要放置在本地计算机上的文件的名称。
例外
另一个线程正在使用指定的 fileName 本地文件。
注解
Caution
WebRequest、 HttpWebRequest、 ServicePoint和 WebClient 已过时，不应将其用于新开发。 改用 HttpClient。
此方法在参数中指定的 address URI 处下载资源。 下载成功完成后，下载的文件将在本地计算机上命名 fileName 。 使用从线程池自动分配的线程资源异步下载该文件。 若要在文件可用时接收通知，请将事件处理程序添加到事件 DownloadFileCompleted 。
此方法不会在下载资源时阻止调用线程。 若要在等待下载完成时阻止，请使用其中 DownloadFile 一种方法。
在 .NET Framework 中，可以通过调用该方法取消尚未完成的 CancelAsync 异步操作。
BaseAddress如果该属性不是空字符串（“”）且address未指定绝对 URI，address则必须是与所请求数据的绝对 URI 组合在一起BaseAddress的相对 URI。 如果 QueryString 属性不是空字符串，则会将其追加到 address。
此方法使用 RETR 命令下载 FTP 资源。 对于 HTTP 资源，将使用 GET 方法。
注释
在应用程序中启用网络跟踪时，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework 中的 Network Tracing。
在 ASP.NET 页中使用此方法时，如果页面所执行的帐户无权访问本地文件，则会收到错误。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用情况异常（例如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅由 DownloadFile(Uri, String)..
适用于
DownloadFileAsync(Uri, String, Object)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
将具有指定 URI 的资源下载到本地文件。 此方法不会阻止调用线程。
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName, System::Object ^ userToken);public void DownloadFileAsync(Uri address, string fileName, object? userToken);public void DownloadFileAsync(Uri address, string fileName, object userToken);member this.DownloadFileAsync : Uri * string * obj -> unitPublic Sub DownloadFileAsync (address As Uri, fileName As String, userToken As Object)参数
- address
- Uri
要下载的资源的 URI。
- fileName
- String
要放置在本地计算机上的文件的名称。
- userToken
- Object
在异步操作完成时传递给调用的方法的用户定义对象。
例外
另一个线程正在使用指定的 fileName 本地文件。
注解
Caution
WebRequest、 HttpWebRequest、 ServicePoint和 WebClient 已过时，不应将其用于新开发。 改用 HttpClient。
此方法在参数中指定的 address URI 处下载资源。 下载成功完成后，下载的文件将在本地计算机上命名 fileName 。 使用从线程池自动分配的线程资源异步下载该文件。 若要在文件可用时接收通知，请将事件处理程序添加到事件 DownloadFileCompleted 。
此方法不会在下载资源时阻止调用线程。 若要在等待下载完成时阻止，请使用其中 DownloadFile 一种方法。
在 .NET Framework 中，可以通过调用该方法取消尚未完成的 CancelAsync 异步操作。
BaseAddress如果该属性不是空字符串（“”）且address未指定绝对 URI，address则必须是与所请求数据的绝对 URI 组合在一起BaseAddress的相对 URI。 如果 QueryString 属性不是空字符串，则会将其追加到 address。
此方法使用 RETR 命令下载 FTP 资源。 对于 HTTP 资源，将使用 GET 方法。
注释
在应用程序中启用网络跟踪时，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework 中的 Network Tracing。
在 ASP.NET 页中使用此方法时，如果页面所执行的帐户无权访问本地文件，则会收到错误。
