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 无效。

-或-

打开流时出错。

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

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

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

注意

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

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

如果 BaseAddress 属性不是空字符串（“”）且 address 不包含绝对 URI，address 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求数据的绝对 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 无效。

-或-

打开流时出错。

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

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

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

注意

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

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

如果 BaseAddress 属性不是空字符串（“”）且 address 不包含绝对 URI，address 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求数据的绝对 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 和 STOR for ftp。

返回

Task<Stream>

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

例外

ArgumentNullException

address 参数 null。

WebException

组合 BaseAddress 和 address 形成的 URI 无效。

-或-

打开流时出错。

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

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

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

注意

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

如果 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

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 和 STOR for ftp。

返回

Task<Stream>

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

例外

ArgumentNullException

address 参数 null。

WebException

组合 BaseAddress 和 address 形成的 URI 无效。

-或-

打开流时出错。

注解

谨慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已过时，不应将其用于新开发。 请改用 HttpClient。

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

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

注意

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

如果 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