WebClient.OpenWriteAsync 方法

  • 参考

定义

命名空间:
System.Net
程序集:
System.Net.WebClient.dll
程序集:
System.dll
程序集:
netstandard.dll

打开一个流以将数据写入指定的资源。 这些方法不阻止调用线程。

重载

OpenWriteAsync(Uri, String, Object)

打开一个流以使用指定的方法向指定的资源写入数据。 此方法不会阻止调用线程。
OpenWriteAsync(Uri, String)

打开一个流以将数据写入指定的资源。 此方法不会阻止调用线程。
OpenWriteAsync(Uri)

打开一个流以将数据写入指定的资源。 此方法不会阻止调用线程。

OpenWriteAsync(Uri, String, Object)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

打开一个流以使用指定的方法向指定的资源写入数据。 此方法不会阻止调用线程。

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method, System::Object ^ userToken);
public void OpenWriteAsync (Uri address, string? method, object? userToken);
public void OpenWriteAsync (Uri address, string method, object userToken);
member this.OpenWriteAsync : Uri * string * obj -> unit
Public Sub OpenWriteAsync (address As Uri, method As String, userToken As Object)

参数

address
Uri

接收数据的资源的 URI。

method
String

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

userToken
Object

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

例外

ArgumentNullException

address 参数为 null。

WebException

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

- 或 -

打开流时发生错误。

注解

此方法检索用于将数据发送到资源的可写流。 使用从线程池自动分配的线程资源异步检索流。 若要在流可用时接收通知，请将事件处理程序添加到 OpenWriteCompleted 事件。 关闭流时，流的内容将发送到服务器。

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

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

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

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

备注

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

适用于

OpenWriteAsync(Uri, String)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

打开一个流以将数据写入指定的资源。 此方法不会阻止调用线程。

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method);
public void OpenWriteAsync (Uri address, string? method);
public void OpenWriteAsync (Uri address, string method);
member this.OpenWriteAsync : Uri * string -> unit
Public Sub OpenWriteAsync (address As Uri, method As String)

参数

address
Uri

接收数据的资源的 URI。

method
String

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

例外

ArgumentNullException

address 参数为 null。

注解

此方法检索用于将数据发送到资源的可写流。 使用从线程池自动分配的线程资源检索流。 若要在流可用时接收通知，请将事件处理程序添加到 OpenWriteCompleted 事件。 关闭流时，线程会阻塞，直到将请求发送到 address 并收到响应。

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

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

备注

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

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

适用于

OpenWriteAsync(Uri)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

打开一个流以将数据写入指定的资源。 此方法不会阻止调用线程。

public:
 void OpenWriteAsync(Uri ^ address);
public void OpenWriteAsync (Uri address);
member this.OpenWriteAsync : Uri -> unit
Public Sub OpenWriteAsync (address As Uri)

参数

address
Uri

接收数据的资源的 URI。

例外

ArgumentNullException

address 参数为 null。

注解

此方法检索用于将数据发送到资源的可写流。 使用从线程池自动分配的线程资源检索流。 若要在流可用时接收通知，请将事件处理程序添加到 OpenWriteCompleted 事件。 关闭流时，线程会阻塞，直到将请求发送到 address 并收到响应。

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

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

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

备注

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

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

适用于