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)

來源:

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)

來源:

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)

來源:

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)

來源:

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 中的網路追蹤。