WebClient.UploadDataAsync 方法

定义

命名空间:

System.Net

程序集:

System.Net.WebClient.dll

将数据缓冲区上载到由 URI 标识的资源。 此方法不会阻止调用线程。

重载

UploadDataAsync(Uri, String, Byte[])	使用指定的方法将数据缓冲区上载到由 URI 标识的资源。 此方法不会阻止调用线程。
UploadDataAsync(Uri, String, Byte[], Object)	使用指定的方法和标识标记将数据缓冲区上载到由 URI 标识的资源。
UploadDataAsync(Uri, Byte[])	使用 POST 方法将数据缓冲区上载到由 URI 标识的资源。 此方法不会阻止调用线程。

UploadDataAsync(Uri, String, Byte[])

Source:

WebClient.cs

使用指定的方法将数据缓冲区上载到由 URI 标识的资源。 此方法不会阻止调用线程。

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public void UploadDataAsync (Uri address, string? method, byte[] data);

member this.UploadDataAsync : Uri * string * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte())

参数

address

Uri

接收数据的资源的 URI。

method

String

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

data

Byte[]

要发送到资源的数据缓冲。

例外

ArgumentNullException

address 参数为 null。

WebException

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

- 或 -

打开流时发生错误。

- 或 -

承载资源的服务器没有响应。

注解

此方法将数据缓冲区发送到资源。 数据缓冲区使用从线程池自动分配的线程资源异步发送。 数据未编码。 若要在数据上传完成时接收通知，请向 UploadDataCompleted 事件添加事件处理程序。

此方法不会在发送数据时阻止调用线程。 若要在等待服务器的响应时发送数据和阻止，请使用 方法之 UploadData 一。

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

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

备注

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

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

UploadDataAsync(Uri, String, Byte[], Object)

Source:

WebClient.cs

使用指定的方法和标识标记将数据缓冲区上载到由 URI 标识的资源。

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data, System::Object ^ userToken);

public void UploadDataAsync (Uri address, string? method, byte[] data, object? userToken);

member this.UploadDataAsync : Uri * string * byte[] * obj -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte(), userToken As Object)

参数

address

Uri

接收数据的资源的 URI。

method

String

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

data

Byte[]

要发送到资源的数据缓冲。

userToken

Object

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

例外

ArgumentNullException

address 参数为 null。

WebException

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

- 或 -

打开流时发生错误。

- 或 -

承载资源的服务器没有响应。

注解

此方法将数据缓冲区发送到资源。 数据缓冲区使用从线程池自动分配的线程资源异步发送。 数据未编码。 若要在数据上传完成时接收通知，请向 UploadDataCompleted 事件添加事件处理程序。

此方法不会在发送数据时阻止调用线程。 若要在等待服务器的响应时发送数据和阻止，请使用 方法之 UploadData 一。

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

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

备注

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

UploadDataAsync(Uri, Byte[])

Source:

WebClient.cs

使用 POST 方法将数据缓冲区上载到由 URI 标识的资源。 此方法不会阻止调用线程。

public:
 void UploadDataAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public void UploadDataAsync (Uri address, byte[] data);

member this.UploadDataAsync : Uri * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, data As Byte())

参数

address

Uri

接收数据的资源的 URI。

data

Byte[]

要发送到资源的数据缓冲。

例外

ArgumentNullException

address 参数为 null。

WebException

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

- 或 -

打开流时发生错误。

- 或 -

承载资源的服务器没有响应。

注解

此方法将数据缓冲区发送到资源。 数据缓冲区使用从线程池自动分配的线程资源异步发送。 数据未编码。 若要在数据上传完成时接收通知，请向 UploadDataCompleted 事件添加事件处理程序。

此方法不会在发送数据时阻止调用线程。 若要在等待服务器的响应时发送数据和阻止，请使用 方法之 UploadData 一。

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

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

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

备注

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

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