WebClient.UploadValuesAsync 方法

定义

命名空间:

System.Net

程序集:

System.Net.WebClient.dll

将指定的名称/值集合上载到指定的 URI 所标识的资源。 这些方法不阻止调用线程。

重载

UploadValuesAsync(Uri, NameValueCollection)	将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。 此方法不会阻止调用线程。
UploadValuesAsync(Uri, String, NameValueCollection)	使用指定的方法将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。 此方法不会阻止调用线程。
UploadValuesAsync(Uri, String, NameValueCollection, Object)	使用指定的方法将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。 此方法不会阻止调用线程，并允许调用方将对象传递给操作完成时所调用的方法。

UploadValuesAsync(Uri, NameValueCollection)

Source:

WebClient.cs

将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。 此方法不会阻止调用线程。

public:
 void UploadValuesAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync (Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, data As NameValueCollection)

参数

address

Uri

接收集合的资源的 URI。 此 URI 必须标识可以接受使用默认方法发送的请求的资源。

data

NameValueCollection

要发送到资源的 NameValueCollection。

例外

ArgumentNullException

address 参数为 null。

- 或 -

data 参数为 null。

WebException

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

- 或 -

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

注解

此方法将字符串发送到资源。 字符串是使用从线程池自动分配的线程资源异步发送的。 在上传字符串之前，此方法使用 属性中指定的Encoding编码将其Byte转换为数组。 若要在字符串上传完成时接收通知，可以向 UploadStringCompleted 事件添加事件处理程序。

此方法不会在发送字符串时阻止调用线程。 若要在等待服务器的响应时发送字符串并阻止，请使用 方法之 UploadString 一。

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

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

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

备注

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

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

UploadValuesAsync(Uri, String, NameValueCollection)

Source:

WebClient.cs

使用指定的方法将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。 此方法不会阻止调用线程。

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection)

参数

address

Uri

接收集合的资源的 URI。 此 URI 必须标识可以接受使用 method 方法发送的请求的资源。

method

String

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

data

NameValueCollection

要发送到资源的 NameValueCollection。

例外

ArgumentNullException

address 参数为 null。

- 或 -

data 参数为 null。

WebException

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

- 或 -

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

- 或 -

method 不能用来发送内容。

注解

此方法将 中包含的 NameValueCollection 数据发送到 address 资源。 使用此方法可将表单数据发送到 URI 进行处理。 使用 form-urlencoded 媒体类型发送数据;Content-Type 标头值必须设置为“application/x-www-form-urlencoded”。 默认情况下，标头设置正确。 如果在集合中Headers设置了不同的 Content-Type 标头值调用此方法，则UploadValuesAsync方法将引发 WebException 。

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

NameValueCollection使用从线程池自动分配的线程资源以异步方式发送。 若要在上传操作完成时接收通知，请将事件处理程序添加到 UploadValuesCompleted 事件。

此方法不会在发送字符串时阻止调用线程。 若要在等待服务器的响应时发送字符串并阻止，请使用 方法之 UploadValues 一。

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

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

备注

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

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

UploadValuesAsync(Uri, String, NameValueCollection, Object)

Source:

WebClient.cs

使用指定的方法将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。 此方法不会阻止调用线程，并允许调用方将对象传递给操作完成时所调用的方法。

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data, System::Object ^ userToken);

public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data, object? userToken);

member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection * obj -> unit

Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection, userToken As Object)

参数

address

Uri

接收集合的资源的 URI。 此 URI 必须标识可以接受使用 method 方法发送的请求的资源。

method

String

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

data

NameValueCollection

要发送到资源的 NameValueCollection。

userToken

Object

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

例外

ArgumentNullException

address 参数为 null。

- 或 -

data 参数为 null。

WebException

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

- 或 -

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

- 或 -

method 不能用来发送内容。

注解

此方法将 中包含的 NameValueCollection 数据发送到 address 资源。 使用此方法可将表单数据发送到 URI 进行处理。 使用 form-urlencoded 媒体类型发送数据;Content-Type 标头值必须设置为“application/x-www-form-urlencoded”。 默认情况下，标头设置正确。 如果在集合中Headers设置了不同的 Content-Type 标头值调用此方法，则UploadValuesAsync方法将引发 WebException 。

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

NameValueCollection使用从线程池自动分配的线程资源以异步方式发送。 若要在上传操作完成时接收通知，请将事件处理程序添加到 UploadValuesCompleted 事件。

此方法不会在发送字符串时阻止调用线程。 若要在等待服务器的响应时发送字符串并阻止，请使用 方法之 UploadValues 一。

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

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

备注

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