WebClient.UploadFileTaskAsync 方法

定义

命名空间:

System.Net

程序集:

System.Net.WebClient.dll

使用任务对象将指定本地文件上载到资源以作为异步操作。 这些方法不阻止调用线程。

重载

UploadFileTaskAsync(Uri, String, String)	使用任务对象将指定本地文件上载到资源以作为异步操作。
UploadFileTaskAsync(String, String, String)	使用任务对象将指定本地文件上载到资源以作为异步操作。
UploadFileTaskAsync(String, String)	使用任务对象将指定本地文件上载到资源以作为异步操作。
UploadFileTaskAsync(Uri, String)	使用任务对象将指定本地文件上载到资源以作为异步操作。

UploadFileTaskAsync(Uri, String, String)

Source:

WebClient.cs

使用任务对象将指定本地文件上载到资源以作为异步操作。

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

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

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

Public Function UploadFileTaskAsync (address As Uri, method As String, fileName As String) As Task(Of Byte())

参数

address

Uri

接收文件的资源的 URI。 对于 HTTP 资源，此 URI 必须标识可以接受用 POST 方法发送的请求的资源，如脚本或 ASP 页。

method

String

用于将数据发送到资源的方法。 如果为 null，则对于 http 默认值为 POST，对于 ftp 默认值为 STOR。

fileName

String

要发送到资源的本地文件。

返回

Task<Byte[]>

表示异步操作的任务对象。 任务对象上的 Result 属性将返回 Byte 数组，该数组包含在上载文件时从资源接收的响应的正文。

例外

ArgumentNullException

address 参数为 null。

- 或 -

fileName 参数为 null。

WebException

通过组合 BaseAddress 和 address 所构成的 URI 无效。

- 或 -

fileName 为 null、为 Empty、包含无效字符或者指定的文件路径不存在。

- 或 -

打开流时发生错误。

- 或 -

承载资源的服务器没有响应。

- 或 -

Content-type 标头以 multipart 开头。

注解

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

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

BaseAddress如果 属性不是空字符串 (“”) ，address则必须是一个相对 URI，与 BaseAddress 组合在一起才能形成所请求数据的绝对 URI。 QueryString如果 属性不是空字符串，则会将其追加到 address。

默认情况下，此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源，使用 POST 方法。

备注

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

UploadFileTaskAsync(String, String, String)

Source:

WebClient.cs

使用任务对象将指定本地文件上载到资源以作为异步操作。

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

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

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

Public Function UploadFileTaskAsync (address As String, method As String, fileName As String) As Task(Of Byte())

参数

address

String

接收文件的资源的 URI。 对于 HTTP 资源，此 URI 必须标识可以接受用 POST 方法发送的请求的资源，如脚本或 ASP 页。

method

String

用于将数据发送到资源的方法。 如果为 null，则对于 http 默认值为 POST，对于 ftp 默认值为 STOR。

fileName

String

要发送到资源的本地文件。

返回

Task<Byte[]>

表示异步操作的任务对象。 任务对象上的 Result 属性将返回 Byte 数组，该数组包含在上载文件时从资源接收的响应的正文。

例外

ArgumentNullException

address 参数为 null。

- 或 -

fileName 参数为 null。

WebException

通过组合 BaseAddress 和 address 所构成的 URI 无效。

- 或 -

fileName 为 null、为 Empty、包含无效字符或者指定的文件路径不存在。

- 或 -

打开流时发生错误。

- 或 -

承载资源的服务器没有响应。

- 或 -

Content-type 标头以 multipart 开头。

注解

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

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

BaseAddress如果 属性不是空字符串 (“”) ，address则必须是一个相对 URI，与 BaseAddress 组合在一起才能形成所请求数据的绝对 URI。 QueryString如果 属性不是空字符串，则会将其追加到 address。

默认情况下，此方法使用 STOR 命令上传 FTP 资源。 对于 HTTP 资源，使用 POST 方法。

备注

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

UploadFileTaskAsync(String, String)

Source:

WebClient.cs

使用任务对象将指定本地文件上载到资源以作为异步操作。

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

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

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

Public Function UploadFileTaskAsync (address As String, fileName As String) As Task(Of Byte())

参数

address

String

接收文件的资源的 URI。 对于 HTTP 资源，此 URI 必须标识可以接受用 POST 方法发送的请求的资源，如脚本或 ASP 页。

fileName

String

要发送到资源的本地文件。

返回

Task<Byte[]>

表示异步操作的任务对象。 任务对象上的 Result 属性将返回 Byte 数组，该数组包含在上载文件时从资源接收的响应的正文。

例外

ArgumentNullException

address 参数为 null。

- 或 -

fileName 参数为 null。

WebException

通过组合 BaseAddress 和 address 所构成的 URI 无效。

- 或 -

fileName 为 null、为 Empty、包含无效字符或者指定的文件路径不存在。

- 或 -

打开流时发生错误。

- 或 -

承载资源的服务器没有响应。

- 或 -

Content-type 标头以 multipart 开头。

注解

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

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

BaseAddress如果 属性不是空字符串 (“”) ，address则必须是一个相对 URI，与 BaseAddress 组合在一起才能形成所请求数据的绝对 URI。 QueryString如果 属性不是空字符串，则会将其追加到 address。

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

备注

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

UploadFileTaskAsync(Uri, String)

Source:

WebClient.cs

使用任务对象将指定本地文件上载到资源以作为异步操作。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string fileName);

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

Public Function UploadFileTaskAsync (address As Uri, fileName As String) As Task(Of Byte())

参数

address

Uri

接收文件的资源的 URI。 对于 HTTP 资源，此 URI 必须标识可以接受用 POST 方法发送的请求的资源，如脚本或 ASP 页。

fileName

String

要发送到资源的本地文件。

返回

Task<Byte[]>

表示异步操作的任务对象。 任务对象上的 Result 属性将返回 Byte 数组，该数组包含在上载文件时从资源接收的响应的正文。

例外

ArgumentNullException

address 参数为 null。

- 或 -

fileName 参数为 null。

WebException

通过组合 BaseAddress 和 address 所构成的 URI 无效。

- 或 -

fileName 为 null、为 Empty、包含无效字符或者指定的文件路径不存在。

- 或 -

打开流时发生错误。

- 或 -

承载资源的服务器没有响应。

- 或 -

Content-type 标头以 multipart 开头。

注解

此操作不会阻止。 返回 Task<TResult> 的对象将在文件上传到资源后完成。 使用从线程池自动分配的线程资源以异步方式发送文件。

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

BaseAddress如果属性不是空字符串 (“”) ，address则必须是一个相对 URI，与 BaseAddress 组合在一起以构成请求数据的绝对 URI。 QueryString如果 属性不是空字符串，则会将其追加到 address。

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

备注

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