WebClient.OpenReadTaskAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
使用任务对象以异步操作的形式打开包含指定资源的可读流。 这些方法不会阻止调用线程。
重载
| OpenReadTaskAsync(String) |
使用任务对象以异步操作的形式打开包含指定资源的可读流。 |
| OpenReadTaskAsync(Uri) |
使用任务对象以异步操作的形式打开包含指定资源的可读流。 |
OpenReadTaskAsync(String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
使用任务对象以异步操作的形式打开包含指定资源的可读流。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(string address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(string address);member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)参数
- address
- String
要检索的资源的 URI。
返回
表示异步操作的任务对象。 任务对象的 Result 属性返回用于从资源读取数据的 Stream。
- 属性
例外
address 参数 null。
注解
谨慎
WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。
此操作不会阻止。 返回的 Task<TResult> 对象将在打开数据资源的可读流后完成。 此方法不会在流打开时阻止调用线程。
此方法检索用于访问 address 参数指定的资源的 Stream 实例。 该流是使用从线程池自动分配的线程资源获取的。
注意
完成 Stream 后，必须调用 Stream.Close，以避免系统资源耗尽。
在 .NET Framework 和 .NET Core 1.0 中，可以通过调用 CancelAsync 方法取消尚未完成的异步操作。
如果 BaseAddress 属性不是空字符串（“”）且 address 未指定绝对 URI，address 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求资源的绝对 URI。 如果未 nullQueryString 属性，则会将其追加到 address。
此方法使用 RETR 命令下载 FTP 资源。 对于 HTTP 资源，将使用 GET 方法。
注意
在应用程序中启用网络跟踪时，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework中的
另请参阅
适用于
OpenReadTaskAsync(Uri)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
使用任务对象以异步操作的形式打开包含指定资源的可读流。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(Uri address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(Uri address);member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)参数
- address
- Uri
要检索的资源的 URI。
返回
表示异步操作的任务对象。 任务对象的 Result 属性返回用于从资源读取数据的 Stream。
- 属性
例外
address 参数 null。
注解
谨慎
WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。
此操作不会阻止。 返回的 Task<TResult> 对象将在打开数据资源的可读流后完成。 此方法不会在流打开时阻止调用线程。
此方法检索用于访问 address 参数指定的资源的 Stream 实例。 该流是使用从线程池自动分配的线程资源获取的。
注意
完成 Stream 后，必须调用 Stream.Close，以避免系统资源耗尽。
在 .NET Framework 和 .NET Core 1.0 中，可以通过调用 CancelAsync 方法取消尚未完成的异步操作。
如果 BaseAddress 属性不是空字符串（“”）且 address 未指定绝对 URI，address 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求资源的绝对 URI。 如果未 nullQueryString 属性，则会将其追加到 address。
此方法使用 RETR 命令下载 FTP 资源。 对于 HTTP 资源，将使用 GET 方法。
注意
在应用程序中启用网络跟踪时，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework中的
