WebClient.OpenWriteTaskAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
使用任务对象打开用于将数据写入指定资源的流以作为异步操作。 这些方法不阻止调用线程。
重载
| OpenWriteTaskAsync(String) |
使用任务对象打开用于将数据写入指定资源的流以作为异步操作。 |
| OpenWriteTaskAsync(Uri) |
使用任务对象打开用于将数据写入指定资源的流以作为异步操作。 |
| OpenWriteTaskAsync(String, String) |
使用任务对象打开用于将数据写入指定资源的流以作为异步操作。 |
| OpenWriteTaskAsync(Uri, String) |
使用任务对象打开用于将数据写入指定资源的流以作为异步操作。 |
OpenWriteTaskAsync(String)
使用任务对象打开用于将数据写入指定资源的流以作为异步操作。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)参数
- address
- String
接收数据的资源的 URI。
返回
表示异步操作的任务对象。 任务对象上的 Result 属性将返回用于将数据写入资源的 Stream 数组。
- 属性
例外
address 参数为 null。
注解
此操作不会阻止。 返回 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(Uri)
使用任务对象打开用于将数据写入指定资源的流以作为异步操作。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)参数
- address
- Uri
接收数据的资源的 URI。
返回
表示异步操作的任务对象。 任务对象上的 Result 属性将返回用于将数据写入资源的 Stream 数组。
- 属性
例外
address 参数为 null。
注解
此操作不会阻止。 返回 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)
使用任务对象打开用于将数据写入指定资源的流以作为异步操作。
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);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string method);[System.Runtime.InteropServices.ComVisible(false)]
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>[<System.Runtime.InteropServices.ComVisible(false)>]
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。
返回
表示异步操作的任务对象。 任务对象上的 Result 属性将返回用于将数据写入资源的 Stream 数组。
- 属性
例外
address 参数为 null。
注解
此操作不会阻止。 返回 Task<TResult> 的对象将在打开数据资源的可写流后完成。 此方法在流打开时不会阻止调用线程。
此方法检索用于 Stream 将数据写入参数指定的 address 资源的实例。 流是使用从线程池自动分配的线程资源获取的。
备注
完成系统资源时Stream必须调用Stream.Close，以避免系统资源耗尽。
method如果参数指定服务器无法理解的方法，则基础协议类将确定发生的情况。 通常，将引发Status一个WebException属性集来指示错误。
在 .NET Framework 和 .NET Core 1.0 中，可以通过调用方法取消尚未完成的CancelAsync异步操作。
BaseAddress如果该属性不是空字符串 (“”) address且不包含绝对 URI，address则必须是与所请求数据的绝对 URI 组合在一起BaseAddress的相对 URI。 QueryString如果该属性不是空字符串，则会将其追加到 address。
此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源，将使用 POST 方法。
当你在应用程序中启用网络跟踪后，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework 中的网络跟踪。
另请参阅
适用于
OpenWriteTaskAsync(Uri, String)
使用任务对象打开用于将数据写入指定资源的流以作为异步操作。
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);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string method);[System.Runtime.InteropServices.ComVisible(false)]
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>[<System.Runtime.InteropServices.ComVisible(false)>]
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。
返回
表示异步操作的任务对象。 任务对象上的 Result 属性将返回用于将数据写入资源的 Stream 数组。
- 属性
例外
address 参数为 null。
注解
此操作不会阻止。 返回 Task<TResult> 的对象将在打开数据资源的可写流后完成。 此方法在流打开时不会阻止调用线程。
此方法检索用于 Stream 将数据写入参数指定的 address 资源的实例。 流是使用从线程池自动分配的线程资源获取的。
备注
完成系统资源时Stream必须调用Stream.Close，以避免系统资源耗尽。
method如果参数指定服务器无法理解的方法，则基础协议类将确定发生的情况。 通常，将引发Status一个WebException属性集来指示错误。
在 .NET Framework 和 .NET Core 1.0 中，可以通过调用方法取消尚未完成的CancelAsync异步操作。
BaseAddress如果该属性不是空字符串 (“”) address且不包含绝对 URI，address则必须是与所请求数据的绝对 URI 组合在一起BaseAddress的相对 URI。 QueryString如果该属性不是空字符串，则会将其追加到 address。
此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源，将使用 POST 方法。
当你在应用程序中启用网络跟踪后，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework 中的网络跟踪。