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开头。

注解

谨慎

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

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

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

如果 BaseAddress 属性不是空字符串（“”），address 必须是与 BaseAddress 相结合的相对 URI，以形成所请求数据的绝对 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开头。

注解

谨慎

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

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

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

如果 BaseAddress 属性不是空字符串（“”），address 必须是与 BaseAddress 相结合的相对 URI，以形成所请求数据的绝对 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开头。

注解

谨慎

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

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

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

如果 BaseAddress 属性不是空字符串（“”），address 必须是与 BaseAddress 相结合的相对 URI，以形成所请求数据的绝对 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开头。

注解

谨慎

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

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

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

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

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

注意

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