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

使用任务对象将指定的名称/值集合上传到由指定 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”。

注解

谨慎

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

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

在 .NET Framework 和 .NET Core 1.0 中，可以通过调用 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中的网络跟踪。

适用于

UploadValuesTaskAsync(String, NameValueCollection)

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”。

注解

谨慎

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

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

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

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

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

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

注意

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

适用于

UploadValuesTaskAsync(Uri, NameValueCollection)

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。

注解

谨慎

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

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

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

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

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

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

注意

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

适用于

UploadValuesTaskAsync(Uri, String, NameValueCollection)

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”。

注解

谨慎

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

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

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

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

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

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

注意

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

适用于

反馈

此页面是否有帮助？