WebClient.UploadFileAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將指定的本機檔案上載至指定的資源。 這些方法不會封鎖呼叫執行緒。
多載
UploadFileAsync(Uri, String) |
使用 POST 方法,將指定的本機檔案上載至指定的資源。 這個方法不會封鎖呼叫執行緒。 |
UploadFileAsync(Uri, String, String) |
使用 POST 方法,將指定的本機檔案上載至指定的資源。 這個方法不會封鎖呼叫執行緒。 |
UploadFileAsync(Uri, String, String, Object) |
使用 POST 方法,將指定的本機檔案上載至指定的資源。 這個方法不會封鎖呼叫執行緒。 |
UploadFileAsync(Uri, String)
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
使用 POST 方法,將指定的本機檔案上載至指定的資源。 這個方法不會封鎖呼叫執行緒。
public:
void UploadFileAsync(Uri ^ address, System::String ^ fileName);
public void UploadFileAsync (Uri address, string fileName);
member this.UploadFileAsync : Uri * string -> unit
Public Sub UploadFileAsync (address As Uri, fileName As String)
參數
- address
- Uri
要接收檔案之資源的 URI。 對於 HTTP 資源而言,這個 URI 必須識別出可以接受使用 POST 方法傳送之要求的資源,例如指令碼或 ASP 網頁。
- fileName
- String
要傳送至資源的檔案。
例外狀況
合併 BaseAddress 和 address
而形成的 URI 是無效的。
-或-
fileName
是 null
、Empty、含有無效的字元,或者指定的檔案路徑不存在。
-或-
開啟資料流時發生錯誤。
-或-
沒有來自裝載 (Host) 資源之伺服器的回應。
-或-
以 Content-type
開頭的 multipart
頁首。
備註
檔案會使用從執行緒集區自動設定的執行緒資源,以非同步方式傳送。 若要在檔案上傳完成時收到通知,請將事件處理常式新增至 UploadFileCompleted 事件。
這個方法不會在傳送檔案時封鎖呼叫執行緒。 若要在等候伺服器的回應時傳送檔案和封鎖,請使用其中 UploadFile 一種方法。
在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 方法來取消尚未完成的 CancelAsync 非同步作業。
BaseAddress如果屬性不是空字串 (「」) , address
則必須是結合 BaseAddress 的相對 URI,才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串,則會附加至 address
。
此方法會使用 STOR 命令來上傳 FTP 資源。 針對 HTTP 資源,會使用 POST 方法。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework 中的網路追蹤。
這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException 仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 UploadFile(Uri, String) 例外狀況。
適用於
UploadFileAsync(Uri, String, String)
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
使用 POST 方法,將指定的本機檔案上載至指定的資源。 這個方法不會封鎖呼叫執行緒。
public:
void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName);
public void UploadFileAsync (Uri address, string? method, string fileName);
public void UploadFileAsync (Uri address, string method, string fileName);
member this.UploadFileAsync : Uri * string * string -> unit
Public Sub UploadFileAsync (address As Uri, method As String, fileName As String)
參數
- address
- Uri
要接收檔案之資源的 URI。 對於 HTTP 資源而言,這個 URI 必須識別出可以接受使用 POST 方法傳送之要求的資源,例如指令碼或 ASP 網頁。
- method
- String
傳送資料給資源所使用的方法。 如果是 null
,預設的 HTTP 為 POST,而 FTP 則為 STOR。
- fileName
- String
要傳送至資源的檔案。
例外狀況
合併 BaseAddress 和 address
而形成的 URI 是無效的。
-或-
fileName
是 null
、Empty、含有無效的字元,或者指定的檔案路徑不存在。
-或-
開啟資料流時發生錯誤。
-或-
沒有來自裝載 (Host) 資源之伺服器的回應。
-或-
以 Content-type
開頭的 multipart
頁首。
備註
檔案會使用從執行緒集區自動設定的執行緒資源,以非同步方式傳送。 若要在檔案上傳完成時收到通知,請將事件處理常式新增至 UploadFileCompleted 事件。
這個方法不會在傳送檔案時封鎖呼叫執行緒。 若要在等候伺服器的回應時傳送檔案和封鎖,請使用其中 UploadFile 一種方法。
在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 方法來取消尚未完成的 CancelAsync 非同步作業。
BaseAddress如果屬性不是空字串 (「」) , address
則必須是結合 BaseAddress 的相對 URI,才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串,則會附加至 address
。
此方法會使用 STOR 命令來上傳 FTP 資源。 針對 HTTP 資源,會使用 POST 方法。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework 中的網路追蹤。
這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException 仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 UploadFile(Uri, String, String) 例外狀況。
適用於
UploadFileAsync(Uri, String, String, Object)
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
使用 POST 方法,將指定的本機檔案上載至指定的資源。 這個方法不會封鎖呼叫執行緒。
public:
void UploadFileAsync(Uri ^ address, System::String ^ method, System::String ^ fileName, System::Object ^ userToken);
public void UploadFileAsync (Uri address, string? method, string fileName, object? userToken);
public void UploadFileAsync (Uri address, string method, string fileName, object userToken);
member this.UploadFileAsync : Uri * string * string * obj -> unit
Public Sub UploadFileAsync (address As Uri, method As String, fileName As String, userToken As Object)
參數
- address
- Uri
要接收檔案之資源的 URI。 對於 HTTP 資源而言,這個 URI 必須識別出可以接受使用 POST 方法傳送之要求的資源,例如指令碼或 ASP 網頁。
- method
- String
傳送資料給資源所使用的方法。 如果是 null
,預設的 HTTP 為 POST,而 FTP 則為 STOR。
- fileName
- String
要傳送至資源的檔案。
- userToken
- Object
使用者定義的物件,這個物件會在非同步作業完成時傳遞至叫用的方法。
例外狀況
合併 BaseAddress 和 address
而形成的 URI 是無效的。
-或-
fileName
是 null
、Empty、含有無效的字元,或者指定的檔案路徑不存在。
-或-
開啟資料流時發生錯誤。
-或-
沒有來自裝載 (Host) 資源之伺服器的回應。
-或-
以 Content-type
開頭的 multipart
頁首。
備註
檔案會使用從執行緒集區自動設定的執行緒資源,以非同步方式傳送。 若要在檔案上傳完成時收到通知,請將事件處理常式新增至 UploadFileCompleted 事件。
這個方法不會在傳送檔案時封鎖呼叫執行緒。 若要在等候伺服器的回應時傳送檔案和封鎖,請使用其中 UploadFile 一種方法。
在 .NET Framework 和 .NET Core 1.0 中,您可以藉由呼叫 方法來取消尚未完成的 CancelAsync 非同步作業。
BaseAddress如果屬性不是空字串 (「」) , address
則必須是結合 BaseAddress 的相對 URI,才能形成要求的絕對 URI。 QueryString如果屬性不是空字串,則會附加至 address
。
此方法會使用 STOR 命令來上傳 FTP 資源。 針對 HTTP 資源,會使用 POST 方法。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework 中的網路追蹤。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應