WebClient.OpenReadAsync 方法

定义

命名空间:

System.Net

程序集:

System.Net.WebClient.dll

打开包含指定资源的可读流。 这些方法不阻止调用线程。

重载

OpenReadAsync(Uri)	打开包含指定资源的可读流。 此方法不会阻止调用线程。
OpenReadAsync(Uri, Object)	打开包含指定资源的可读流。 此方法不会阻止调用线程。

OpenReadAsync(Uri)

Source:

WebClient.cs

打开包含指定资源的可读流。 此方法不会阻止调用线程。

public:
 void OpenReadAsync(Uri ^ address);

public void OpenReadAsync (Uri address);

member this.OpenReadAsync : Uri -> unit

Public Sub OpenReadAsync (address As Uri)

参数

address

Uri

要检索的资源的 URI。

例外

ArgumentNullException

address 参数为 null。

WebException

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

- 或 -

下载资源时出现错误。

- 或 -

打开流时发生错误。

注解

此方法检索 Stream 用于访问 参数 address 指定的资源的实例。 使用从线程池自动分配的线程资源获取流。 若要在流可用时接收通知，请将事件处理程序添加到 OpenReadCompleted 事件。

注意

使用 完成后Stream，必须调用 Stream.Close ，以避免系统资源耗尽。

此方法不会在流打开时阻止调用线程。 若要在等待流时阻止，请使用 OpenReadAsync 方法。

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

BaseAddress如果属性不是空字符串 (“”) ，并且address未指定绝对 URI，address则必须是一个相对 URI，与 BaseAddress 组合以构成所请求资源的绝对 URI。 QueryString如果该属性不是 null，则将其追加到 address。

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

备注

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

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

OpenReadAsync(Uri, Object)

Source:

WebClient.cs

打开包含指定资源的可读流。 此方法不会阻止调用线程。

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

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

member this.OpenReadAsync : Uri * obj -> unit

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

参数

address

Uri

要检索的资源的 URI。

userToken

Object

一个用户定义对象，此对象将传递给完成异步操作后所调用的方法。

例外

ArgumentNullException

address 参数为 null。

WebException

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

- 或 -

下载资源时出现错误。

- 或 -

打开流时发生错误。

注解

此方法检索 Stream 用于访问 参数 address 指定的资源的实例。 使用从线程池自动分配的线程资源获取流。 若要在流可用时接收通知，请将事件处理程序添加到 OpenReadCompleted 事件。

注意

使用 完成后Stream，必须调用 Stream.Close ，以避免系统资源耗尽。

此方法不会在流打开时阻止调用线程。 若要在等待流时阻止，请使用 OpenRead 方法。

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

BaseAddress如果属性不是空字符串 (“”) ，并且address未指定绝对 URI，address则必须是一个相对 URI，与 BaseAddress 组合以构成所请求资源的绝对 URI。 QueryString如果该属性不是 null，则将其追加到 address。

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

备注

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