WebClient.UploadValuesTaskAsync 方法

定义

命名空间:: System.Net

程序集:: netstandard.dll, System.Net.WebClient.dll

程序集:: System.Net.WebClient.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，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

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 和 STOR for ftp。

data: NameValueCollection

要 NameValueCollection 发送到资源。

Task<Byte[]>

表示异步操作的任务对象。 Result任务对象的属性返回一个Byte数组，其中包含服务器发送的响应。

属性: ComVisibleAttribute

例外

ArgumentNullException

参数 address 为 null.

-或-

参数 data 为 null.

WebException

组合 BaseAddress构成的 URI 无效 address 。

-或-

method 不能用于发送内容。

-或-

托管资源的服务器没有响应。

-或-

打开流时出错。

-或-

标头 Content-type 不是 null 或“application/x-www-form-urlencoded”。

注解

Caution

WebRequest、 HttpWebRequest、 ServicePoint和 WebClient 已过时，不应将其用于新开发。改用 HttpClient。

此操作不会阻止。返回 Task<TResult> 的对象将在名称/值集合上传到资源后完成。名称/值集合使用从线程池自动分配的线程资源异步发送。

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

如果服务器无法理解基础请求，基础协议类将确定发生的情况。通常，将引发WebException属性Status集以指示错误。

如果 Content-type 标头为 null，此方法将其设置为“application/x-www-form-urlencoded”。

如果 BaseAddress 属性不是空字符串（“”）且 address 不包含绝对 URI，address 必须是与 BaseAddress 相结合的相对 URI，才能形成所请求数据的绝对 URI。如果 QueryString 属性不是空字符串，则会将其追加到 address。

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

注释

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

适用于

UploadValuesTaskAsync(String, NameValueCollection)

Source:: WebClient.cs

Source:: WebClient.cs

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 发送到资源。

Task<Byte[]>

表示异步操作的任务对象。 Result任务对象的属性返回一个Byte数组，其中包含服务器发送的响应。

属性: ComVisibleAttribute

例外

ArgumentNullException

参数 address 为 null.

-或-

参数 data 为 null.

WebException

组合 BaseAddress构成的 URI 无效 address 。

-或-

托管资源的服务器没有响应。

-或-

打开流时出错。

-或-

标头 Content-type 不是 null 或“application/x-www-form-urlencoded”。

注解

Caution

WebRequest、 HttpWebRequest、 ServicePoint和 WebClient 已过时，不应将其用于新开发。改用 HttpClient。

此操作不会阻止。返回 Task<TResult> 的对象将在名称/值集合上传到资源后完成。名称/值集合使用从线程池自动分配的线程资源异步发送。

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

如果服务器无法理解基础请求，基础协议类将确定发生的情况。通常，将引发WebException属性Status集以指示错误。

如果 Content-type 标头为 null，此方法将其设置为“application/x-www-form-urlencoded”。

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

注释

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

适用于

UploadValuesTaskAsync(Uri, NameValueCollection)

Source:: WebClient.cs

Source:: WebClient.cs

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 发送到资源。

Task<Byte[]>

表示异步操作的任务对象。 Result任务对象的属性返回一个Byte数组，其中包含服务器发送的响应。

属性: ComVisibleAttribute

例外

ArgumentNullException

参数 address 为 null.

-或-

参数 data 为 null.

WebException

组合 BaseAddress构成的 URI 无效 address 。

-或-

打开流时出错。

-或-

托管资源的服务器没有响应。

-或-

标头 Content-type 值不是 null ，不是 application/x-www-form-urlencoded。

注解

Caution

WebRequest、 HttpWebRequest、 ServicePoint和 WebClient 已过时，不应将其用于新开发。改用 HttpClient。

此操作不会阻止。返回 Task<TResult> 的对象将在名称/值集合上传到资源后完成。名称/值集合使用从线程池自动分配的线程资源异步发送。

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

如果服务器无法理解基础请求，基础协议类将确定发生的情况。通常，将引发WebException属性Status集以指示错误。

如果 Content-type 标头为 null，此方法将其设置为“application/x-www-form-urlencoded”。

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

注释

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

适用于

UploadValuesTaskAsync(Uri, String, NameValueCollection)

Source:: WebClient.cs

Source:: WebClient.cs

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 和 STOR for ftp。

data: NameValueCollection

要 NameValueCollection 发送到资源。

Task<Byte[]>

表示异步操作的任务对象。 Result任务对象的属性返回一个Byte数组，其中包含服务器发送的响应。

属性: ComVisibleAttribute

例外

ArgumentNullException

参数 address 为 null.

-或-

参数 data 为 null.

WebException

组合 BaseAddress构成的 URI 无效 address 。

-或-

method 不能用于发送内容。

-或-

托管资源的服务器没有响应。

-或-

打开流时出错。

-或-

标头 Content-type 不是 null 或“application/x-www-form-urlencoded”。

注解

Caution

WebRequest、 HttpWebRequest、 ServicePoint和 WebClient 已过时，不应将其用于新开发。改用 HttpClient。

此操作不会阻止。返回 Task<TResult> 的对象将在名称/值集合上传到资源后完成。名称/值集合使用从线程池自动分配的线程资源异步发送。

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

如果服务器无法理解基础请求，基础协议类将确定发生的情况。通常，将引发WebException属性Status集以指示错误。

如果 Content-type 标头为 null，此方法将其设置为“application/x-www-form-urlencoded”。

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

注释

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

适用于

反馈

此页面是否有帮助？