WebClient.UploadValuesAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将指定的名称/值集合上载到指定的 URI 所标识的资源。 这些方法不阻止调用线程。
重载
UploadValuesAsync(Uri, NameValueCollection) |
将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。 此方法不会阻止调用线程。 |
UploadValuesAsync(Uri, String, NameValueCollection) |
使用指定的方法将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。 此方法不会阻止调用线程。 |
UploadValuesAsync(Uri, String, NameValueCollection, Object) |
使用指定的方法将指定的名称/值集合中的数据上载到由指定的 URI 标识的资源。 此方法不会阻止调用线程,并允许调用方将对象传递给操作完成时所调用的方法。 |
UploadValuesAsync(Uri, NameValueCollection)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- 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。
例外
注解
此方法将字符串发送到资源。 字符串使用从线程池自动分配的线程资源异步发送。 在上传字符串之前,此方法使用 属性中指定的Encoding编码将其Byte转换为数组。 若要在字符串上传完成时接收通知,可以向 UploadStringCompleted 事件添加事件处理程序。
此方法不会在发送字符串时阻止调用线程。 若要在等待服务器的响应时发送字符串并阻止,请使用 方法之 UploadString 一。
在 .NET Framework 和 .NET Core 1.0 中,可以通过调用 方法取消尚未完成的 CancelAsync 异步操作。
BaseAddress如果 属性不是空字符串 (“”) ,并且address
不包含绝对 URI,address
则必须是与 BaseAddress 组合在一起以构成所请求数据的绝对 URI 的相对 URI。 QueryString如果 属性不是空字符串,则会将其追加到 address
。
此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源,使用 POST 方法。
备注
当你在应用程序中启用网络跟踪后,此成员将输出跟踪信息。 有关详细信息,请参阅 .NET Framework 中的网络跟踪。
此方法存储在任务中,它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中,则在等待任务时将引发该异常。 使用异常(如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅 引发的 UploadValues(Uri, NameValueCollection)异常。
适用于
UploadValuesAsync(Uri, String, NameValueCollection)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- 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);
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。
例外
注解
此方法将 中包含的 NameValueCollection 数据发送到 address
资源。 使用此方法可将表单数据发送到 URI 进行处理。 使用表单 urlencoded 媒体类型发送数据;Content-Type 标头值必须设置为“application/x-www-form-urlencoded”。 默认情况下,标头设置正确。 如果在集合中设置了不同的 Content-Type 标头值调用此方法,Headers则UploadValuesAsync方法将引发 WebException 。
method
如果服务器无法理解该方法,则基础协议类将确定所发生的情况。 通常, WebException 会引发 ,并将 Status 属性设置为 指示错误。
NameValueCollection使用从线程池自动分配的线程资源异步发送 。 若要在上传操作完成时接收通知,请将事件处理程序添加到 事件 UploadValuesCompleted 。
此方法不会在发送字符串时阻止调用线程。 若要在等待服务器的响应时发送字符串并阻止,请使用 方法之 UploadValues 一。
在 .NET Framework 和 .NET Core 1.0 中,可以通过调用 方法取消尚未完成的 CancelAsync 异步操作。
BaseAddress如果 属性不是空字符串 (“”) ,并且address
不包含绝对 URI,address
则必须是与 BaseAddress 组合在一起以构成所请求数据的绝对 URI 的相对 URI。 QueryString如果 属性不为空,则会将其追加到 address
。
备注
当你在应用程序中启用网络跟踪后,此成员将输出跟踪信息。 有关详细信息,请参阅 .NET Framework 中的网络跟踪。
此方法存储在任务中,它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中,则在等待任务时将引发该异常。 使用异常(如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅 引发的 UploadValues(Uri, String, NameValueCollection)异常。
适用于
UploadValuesAsync(Uri, String, NameValueCollection, Object)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- 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);
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
一个用户定义对象,此对象将传递给完成异步操作后所调用的方法。
例外
注解
此方法将 中包含的 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 中的网络跟踪。
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈