WebClient.DownloadStringAsync 方法

参考

定义

命名空间:: System.Net

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

程序集:: System.dll

程序集:: netstandard.dll

重要

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

下载以 String 或 Uri 形式指定的资源。这些方法不阻止调用线程。

重载

DownloadStringAsync(Uri)	下载以 Uri 形式指定的资源。此方法不会阻止调用线程。
DownloadStringAsync(Uri, Object)	将指定的字符串下载到指定的资源。此方法不会阻止调用线程。

DownloadStringAsync(Uri)

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

下载以 Uri 形式指定的资源。此方法不会阻止调用线程。

public:
 void DownloadStringAsync(Uri ^ address);

public void DownloadStringAsync (Uri address);

member this.DownloadStringAsync : Uri -> unit

Public Sub DownloadStringAsync (address As Uri)

参数

address: Uri

包含要下载的 URI 的 Uri。

例外

ArgumentNullException

address 参数为 null。

WebException

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

- 或 -

下载资源时出现错误。

注解

资源是使用从线程池自动分配的线程资源异步下载的。

下载资源后，此方法使用属性中指定的 Encoding 编码将资源转换为 String。下载资源时，此方法不会阻止调用线程。若要下载资源并在等待服务器响应时阻止，请使用 DownloadString 方法。下载完成后，将 DownloadStringCompleted 引发事件。应用程序必须处理此事件才能接收通知。下载的字符串在属性中 Result 可用。

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

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

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

备注

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

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

适用于

DownloadStringAsync(Uri, Object)

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

将指定的字符串下载到指定的资源。此方法不会阻止调用线程。

public:
 void DownloadStringAsync(Uri ^ address, System::Object ^ userToken);

public void DownloadStringAsync (Uri address, object? userToken);

public void DownloadStringAsync (Uri address, object userToken);

member this.DownloadStringAsync : Uri * obj -> unit

Public Sub DownloadStringAsync (address As Uri, userToken As Object)

参数

address: Uri