WebClient.OpenWriteTaskAsync 方法

定义

命名空间:

System.Net

程序集:

System.Net.WebClient.dll

使用任务对象打开用于将数据写入指定资源的流以作为异步操作。 这些方法不阻止调用线程。

重载

OpenWriteTaskAsync(String)	使用任务对象打开用于将数据写入指定资源的流以作为异步操作。
OpenWriteTaskAsync(Uri)	使用任务对象打开用于将数据写入指定资源的流以作为异步操作。
OpenWriteTaskAsync(String, String)	使用任务对象打开用于将数据写入指定资源的流以作为异步操作。
OpenWriteTaskAsync(Uri, String)	使用任务对象打开用于将数据写入指定资源的流以作为异步操作。

OpenWriteTaskAsync(String)

Source:

WebClient.cs

使用任务对象打开用于将数据写入指定资源的流以作为异步操作。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);

member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)

参数

address

String

接收数据的资源的 URI。

返回

Task<Stream>

表示异步操作的任务对象。 任务对象上的 Result 属性将返回用于将数据写入资源的 Stream 数组。

例外

ArgumentNullException

address 参数为 null。

WebException

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

- 或 -

打开流时发生错误。

注解

此操作不会阻止。 打开数据资源的可写流后，返回 Task<TResult> 的对象将完成。 此方法不会在流打开时阻止调用线程。

此方法检索一个实例， Stream 该实例用于将数据写入参数 address 指定的资源。 使用从线程池自动分配的线程资源获取流。

注意

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

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

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

此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源，使用 POST 方法。

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

另请参阅

• Stream

OpenWriteTaskAsync(Uri)

Source:

WebClient.cs

使用任务对象打开用于将数据写入指定资源的流以作为异步操作。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);

member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)

参数

address

Uri

接收数据的资源的 URI。

返回

Task<Stream>

表示异步操作的任务对象。 任务对象上的 Result 属性将返回用于将数据写入资源的 Stream 数组。

例外

ArgumentNullException

address 参数为 null。

WebException

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

- 或 -

打开流时发生错误。

注解

此操作不会阻止。 打开数据资源的可写流后，返回 Task<TResult> 的对象将完成。 此方法不会在流打开时阻止调用线程。

此方法检索一个实例， Stream 该实例用于将数据写入参数 address 指定的资源。 使用从线程池自动分配的线程资源获取流。

注意

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

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

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

此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源，使用 POST 方法。

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

OpenWriteTaskAsync(String, String)

Source:

WebClient.cs

使用任务对象打开用于将数据写入指定资源的流以作为异步操作。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address, System::String ^ method);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string? method);

member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As String, method As String) As Task(Of Stream)

参数

address

String

接收数据的资源的 URI。

method

String

用于将数据发送到资源的方法。 如果为 null，则对于 http 默认值为 POST，对于 ftp 默认值为 STOR。

返回

Task<Stream>

表示异步操作的任务对象。 任务对象上的 Result 属性将返回用于将数据写入资源的 Stream 数组。

例外

ArgumentNullException

address 参数为 null。

WebException

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

- 或 -

打开流时发生错误。

注解

此操作不会阻止。 打开数据资源的可写流后，返回 Task<TResult> 的对象将完成。 此方法不会在流打开时阻止调用线程。

此方法检索一个实例， Stream 该实例用于将数据写入参数 address 指定的资源。 使用从线程池自动分配的线程资源获取流。

注意

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

method如果 参数指定了服务器无法理解的方法，则基础协议类将确定所发生的情况。 通常， WebException 会引发 ，并将 Status 属性设置为指示错误。

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

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

此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源，使用 POST 方法。

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

另请参阅

• Stream

OpenWriteTaskAsync(Uri, String)

Source:

WebClient.cs

使用任务对象打开用于将数据写入指定资源的流以作为异步操作。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address, System::String ^ method);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string? method);

member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As Uri, method As String) As Task(Of Stream)

参数

address

Uri

接收数据的资源的 URI。

method

String

用于将数据发送到资源的方法。 如果为 null，则对于 http 默认值为 POST，对于 ftp 默认值为 STOR。

返回

Task<Stream>

表示异步操作的任务对象。 任务对象上的 Result 属性将返回用于将数据写入资源的 Stream 数组。

例外

ArgumentNullException

address 参数为 null。

WebException

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

- 或 -

打开流时发生错误。

注解

此操作不会阻止。 打开数据资源的可写流后，返回 Task<TResult> 的对象将完成。 此方法不会在流打开时阻止调用线程。

此方法检索一个实例， Stream 该实例用于将数据写入参数 address 指定的资源。 使用从线程池自动分配的线程资源获取流。

注意

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

method如果 参数指定了服务器无法理解的方法，则基础协议类将确定所发生的情况。 通常， WebException 会引发 ，并将 Status 属性设置为 指示错误。

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

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

此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源，使用 POST 方法。

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

另请参阅

• Stream