WebClient.UploadValuesTaskAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
使用任务对象将指定的名称/值集合上载到由指定 URI 标识的资源以作为异步操作。 这些方法不阻止调用线程。
重载
UploadValuesTaskAsync(String, String, NameValueCollection) |
使用任务对象将指定的名称/值集合上载到由指定 URI 标识的资源以作为异步操作。 |
UploadValuesTaskAsync(String, NameValueCollection) |
使用任务对象将指定的名称/值集合上载到由指定 URI 标识的资源以作为异步操作。 |
UploadValuesTaskAsync(Uri, NameValueCollection) |
使用任务对象将指定的名称/值集合上载到由指定 URI 标识的资源以作为异步操作。 |
UploadValuesTaskAsync(Uri, String, NameValueCollection) |
使用任务对象将指定的名称/值集合上载到由指定 URI 标识的资源以作为异步操作。 |
UploadValuesTaskAsync(String, String, NameValueCollection)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
使用任务对象将指定的名称/值集合上载到由指定 URI 标识的资源以作为异步操作。
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string? method, System.Collections.Specialized.NameValueCollection data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string method, System.Collections.Specialized.NameValueCollection data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
Public Function UploadValuesTaskAsync (address As String, method As String, data As NameValueCollection) As Task(Of Byte())
参数
- address
- String
接收集合的资源的 URI。
- method
- String
用于将集合发送到资源的 HTTP 方法。 如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。
- data
- NameValueCollection
要发送到资源的 NameValueCollection。
返回
表示异步操作的任务对象。 任务对象上的 Result 属性将返回包含服务器发送的响应的 Byte 数组。
- 属性
例外
通过组合 BaseAddress 和 address
所构成的 URI 无效。
- 或 -
method
不能用来发送内容。
- 或 -
承载资源的服务器没有响应。
- 或 -
打开流时发生错误。
- 或 -
Content-type
标头不是 null
或“application/x-www-form-urlencoded”。
注解
此操作不会阻止。 返回 Task<TResult> 的对象将在名称/值集合上传到资源后完成。 名称/值集合使用从线程池自动分配的线程资源以异步方式发送。
在 .NET Framework 和 .NET Core 1.0 中,可以通过调用 方法来取消尚未完成的CancelAsync异步操作。
如果服务器无法理解基础请求,基础协议类将确定所发生的情况。 通常, WebException 会引发 ,并将 Status 属性设置为指示错误。
如果 Content-type 标头为 null
,则此方法将其设置为“application/x-www-form-urlencoded”。
BaseAddress如果属性不是空字符串 (“”) ,并且address
不包含绝对 URI,address
则必须是一个相对 URI,与 BaseAddress 组合以构成所请求数据的绝对 URI。 QueryString如果 属性不是空字符串,则会将其追加到 address
。
此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源,使用 POST 方法。
备注
当你在应用程序中启用网络跟踪后,此成员将输出跟踪信息。 有关详细信息,请参阅 .NET Framework 中的网络跟踪。
适用于
UploadValuesTaskAsync(String, NameValueCollection)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
使用任务对象将指定的名称/值集合上载到由指定 URI 标识的资源以作为异步操作。
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, System.Collections.Specialized.NameValueCollection data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
Public Function UploadValuesTaskAsync (address As String, data As NameValueCollection) As Task(Of Byte())
参数
- address
- String
接收集合的资源的 URI。
- data
- NameValueCollection
要发送到资源的 NameValueCollection。
返回
表示异步操作的任务对象。 任务对象上的 Result 属性将返回包含服务器发送的响应的 Byte 数组。
- 属性
例外
通过组合 BaseAddress 和 address
所构成的 URI 无效。
- 或 -
承载资源的服务器没有响应。
- 或 -
打开流时发生错误。
- 或 -
Content-type
标头不是 null
或“application/x-www-form-urlencoded”。
注解
此操作不会阻止。 返回 Task<TResult> 的对象将在名称/值集合上传到资源后完成。 名称/值集合使用从线程池自动分配的线程资源以异步方式发送。
在 .NET Framework 和 .NET Core 1.0 中,可以通过调用 方法来取消尚未完成的CancelAsync异步操作。
如果服务器无法理解基础请求,基础协议类将确定所发生的情况。 通常, WebException 会引发 ,并将 Status 属性设置为指示错误。
如果 Content-type 标头为 null
,则此方法将其设置为“application/x-www-form-urlencoded”。
BaseAddress如果属性不是空字符串 (“”) ,并且address
不包含绝对 URI,address
则必须是一个相对 URI,与 BaseAddress 组合以构成所请求数据的绝对 URI。 QueryString如果 属性不是空字符串,则会将其追加到 address
。
此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源,使用 POST 方法。
备注
当你在应用程序中启用网络跟踪后,此成员将输出跟踪信息。 有关详细信息,请参阅 .NET Framework 中的网络跟踪。
适用于
UploadValuesTaskAsync(Uri, NameValueCollection)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
使用任务对象将指定的名称/值集合上载到由指定 URI 标识的资源以作为异步操作。
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, System.Collections.Specialized.NameValueCollection data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
Public Function UploadValuesTaskAsync (address As Uri, data As NameValueCollection) As Task(Of Byte())
参数
- address
- Uri
接收集合的资源的 URI。
- data
- NameValueCollection
要发送到资源的 NameValueCollection。
返回
表示异步操作的任务对象。 任务对象上的 Result 属性将返回包含服务器发送的响应的 Byte 数组。
- 属性
例外
通过组合 BaseAddress 和 address
所构成的 URI 无效。
- 或 -
打开流时发生错误。
- 或 -
承载资源的服务器没有响应。
- 或 -
Content-type
标头值既不是 null
也不是 application/x-www-form-urlencoded
。
注解
此操作不会阻止。 返回 Task<TResult> 的对象将在名称/值集合上传到资源后完成。 名称/值集合使用从线程池自动分配的线程资源以异步方式发送。
在 .NET Framework 和 .NET Core 1.0 中,可以通过调用 方法来取消尚未完成的CancelAsync异步操作。
如果服务器无法理解基础请求,基础协议类将确定所发生的情况。 通常, WebException 会引发 ,并将 Status 属性设置为指示错误。
如果 Content-type 标头为 null
,则此方法将其设置为“application/x-www-form-urlencoded”。
BaseAddress如果属性不是空字符串 (“”) ,并且address
不包含绝对 URI,address
则必须是一个相对 URI,与 BaseAddress 组合以构成所请求数据的绝对 URI。 QueryString如果 属性不是空字符串,则会将其追加到 address
。
此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源,使用 POST 方法。
备注
当你在应用程序中启用网络跟踪后,此成员将输出跟踪信息。 有关详细信息,请参阅 .NET Framework 中的网络跟踪。
适用于
UploadValuesTaskAsync(Uri, String, NameValueCollection)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
使用任务对象将指定的名称/值集合上载到由指定 URI 标识的资源以作为异步操作。
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>
Public Function UploadValuesTaskAsync (address As Uri, method As String, data As NameValueCollection) As Task(Of Byte())
参数
- address
- Uri
接收集合的资源的 URI。
- method
- String
用于将集合发送到资源的 HTTP 方法。 如果为 null,则对于 http 默认值为 POST,对于 ftp 默认值为 STOR。
- data
- NameValueCollection
要发送到资源的 NameValueCollection。
返回
表示异步操作的任务对象。 任务对象上的 Result 属性将返回包含服务器发送的响应的 Byte 数组。
- 属性
例外
通过组合 BaseAddress 和 address
所构成的 URI 无效。
- 或 -
method
不能用来发送内容。
- 或 -
承载资源的服务器没有响应。
- 或 -
打开流时发生错误。
- 或 -
Content-type
标头不是 null
或“application/x-www-form-urlencoded”。
注解
此操作不会阻止。 返回 Task<TResult> 的对象将在名称/值集合上传到资源后完成。 名称/值集合使用从线程池自动分配的线程资源以异步方式发送。
在 .NET Framework 和 .NET Core 1.0 中,可以通过调用 方法来取消尚未完成的CancelAsync异步操作。
如果服务器无法理解基础请求,基础协议类将确定所发生的情况。 通常, WebException 会引发 ,并将 Status 属性设置为指示错误。
如果 Content-type 标头为 null
,则此方法将其设置为“application/x-www-form-urlencoded”。
BaseAddress如果属性不是空字符串 (“”) ,并且address
不包含绝对 URI,address
则必须是一个相对 URI,与 BaseAddress 组合以构成所请求数据的绝对 URI。 QueryString如果 属性不是空字符串,则会将其追加到 address
。
此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源,使用 POST 方法。
备注
当你在应用程序中启用网络跟踪后,此成员将输出跟踪信息。 有关详细信息,请参阅 .NET Framework 中的网络跟踪。
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈