WebClient.UploadDataTaskAsync 方法

定义

命名空间:: System.Net

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

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

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

使用任务对象将包含 Byte 数组的数据缓冲区上传到指定为异步操作的 URI。这些方法不会阻止调用线程。

重载

UploadDataTaskAsync(String, Byte[])	使用任务对象将包含 Byte 数组的数据缓冲区上传到指定为异步操作的 URI。
UploadDataTaskAsync(Uri, Byte[])	使用任务对象将包含 Byte 数组的数据缓冲区上传到指定为异步操作的 URI。
UploadDataTaskAsync(String, String, Byte[])	使用任务对象将包含 Byte 数组的数据缓冲区上传到指定为异步操作的 URI。
UploadDataTaskAsync(Uri, String, Byte[])	使用任务对象将包含 Byte 数组的数据缓冲区上传到指定为异步操作的 URI。

UploadDataTaskAsync(String, Byte[])

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

使用任务对象将包含 Byte 数组的数据缓冲区上传到指定为异步操作的 URI。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(string address, byte[] data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(string address, byte[] data);

member this.UploadDataTaskAsync : string * byte[] -> System.Threading.Tasks.Task<byte[]>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As String, data As Byte()) As Task(Of Byte())

参数

address: String

要接收数据的资源的 URI。

data: Byte[]

要发送到资源的数据缓冲区。

Task<Byte[]>

表示异步操作的任务对象。任务对象的 Result 属性返回一个 Byte 数组，其中包含上传数据缓冲区时从资源收到的响应正文。

属性: ComVisibleAttribute

例外

ArgumentNullException

address 参数 null。

WebException

组合 BaseAddress 和 address 形成的 URI 无效。

-或-

打开流时出错。

-或-

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

注解

谨慎

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

此操作不会阻止。返回的 Task<TResult> 对象将在数据缓冲区上传到资源后完成。

此方法将数据缓冲区发送到资源。数据缓冲区是使用从线程池自动分配的线程资源异步发送的。数据未编码。

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

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

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

注意

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

适用于

UploadDataTaskAsync(Uri, Byte[])

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

使用任务对象将包含 Byte 数组的数据缓冲区上传到指定为异步操作的 URI。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(Uri address, byte[] data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(Uri address, byte[] data);

member this.UploadDataTaskAsync : Uri * byte[] -> System.Threading.Tasks.Task<byte[]>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : Uri * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As Uri, data As Byte()) As Task(Of Byte())

参数

address: Uri

要接收数据的资源的 URI。

data: Byte[]

要发送到资源的数据缓冲区。

Task<Byte[]>

表示异步操作的任务对象。任务对象的 Result 属性返回一个 Byte 数组，其中包含上传数据缓冲区时从资源收到的响应正文。

属性: ComVisibleAttribute

例外

ArgumentNullException

address 参数 null。

WebException

组合 BaseAddress 和 address 形成的 URI 无效。

-或-

打开流时出错。

-或-

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

注解

谨慎

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

此操作不会阻止。返回的 Task<TResult> 对象将在数据缓冲区上传到资源后完成。

此方法将数据缓冲区发送到资源。数据缓冲区是使用从线程池自动分配的线程资源异步发送的。数据未编码。

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

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

注意

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

适用于

UploadDataTaskAsync(String, String, Byte[])

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

使用任务对象将包含 Byte 数组的数据缓冲区上传到指定为异步操作的 URI。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(string address, string? method, byte[] data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(string address, string method, byte[] data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(string address, string method, byte[] data);

member this.UploadDataTaskAsync : string * string * byte[] -> System.Threading.Tasks.Task<byte[]>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : string * string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As String, method As String, data As Byte()) As Task(Of Byte())

参数

address: String

要接收数据的资源的 URI。

method: String

用于将数据发送到资源的方法。如果 null，则默认为 HTTP 的 POST 和 FTP 的 STOR。

data: Byte[]

要发送到资源的数据缓冲区。

Task<Byte[]>

表示异步操作的任务对象。任务对象的 Result 属性返回一个 Byte 数组，其中包含上传数据缓冲区时从资源收到的响应正文。

属性: ComVisibleAttribute

例外

ArgumentNullException

address 参数 null。

WebException

组合 BaseAddress 和 address 形成的 URI 无效。

-或-

打开流时出错。

-或-

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

注解

谨慎

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

此操作不会阻止。返回的 Task<TResult> 对象将在数据缓冲区上传到资源后完成。

此方法将数据缓冲区发送到资源。数据缓冲区是使用从线程池自动分配的线程资源异步发送的。数据未编码。

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

注意

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

适用于

UploadDataTaskAsync(Uri, String, Byte[])

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

Source:: WebClient.cs

使用任务对象将包含 Byte 数组的数据缓冲区上传到指定为异步操作的 URI。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(Uri address, string? method, byte[] data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(Uri address, string method, byte[] data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync(Uri address, string method, byte[] data);

member this.UploadDataTaskAsync : Uri * string * byte[] -> System.Threading.Tasks.Task<byte[]>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : Uri * string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As Uri, method As String, data As Byte()) As Task(Of Byte())

参数

address: Uri

要接收数据的资源的 URI。

method: String

用于将数据发送到资源的方法。如果 null，则默认为 HTTP 的 POST 和 FTP 的 STOR。

data: Byte[]

要发送到资源的数据缓冲区。

Task<Byte[]>

表示异步操作的任务对象。任务对象的 Result 属性返回一个 Byte 数组，其中包含上传数据缓冲区时从资源收到的响应正文。

属性: ComVisibleAttribute

例外

ArgumentNullException

address 参数 null。

WebException

组合 BaseAddress 和 address 形成的 URI 无效。

-或-

打开流时出错。

-或-

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

注解

谨慎

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

此操作不会阻止。返回的 Task<TResult> 对象将在数据缓冲区上传到资源后完成。

此方法将数据缓冲区发送到资源。数据缓冲区是使用从线程池自动分配的线程资源异步发送的。数据未编码。

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

注意

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

适用于

反馈

此页面是否有帮助？