WebClient.UploadValuesAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將指定的名稱/值集合上載至由指定之 URI 所識別的資源。 這些方法不會封鎖呼叫執行緒。
多載
UploadValuesAsync(Uri, NameValueCollection) |
將指定之名稱/值集合中的資料上載至由指定之 URI 識別的資源。 這個方法不會封鎖呼叫執行緒。 |
UploadValuesAsync(Uri, String, NameValueCollection) |
使用指定的方法,將指定之名稱/值集合中的資料上載至由指定之 URI 所識別的資源。 這個方法不會封鎖呼叫執行緒。 |
UploadValuesAsync(Uri, String, NameValueCollection, Object) |
使用指定的方法,將指定之名稱/值集合中的資料上載至由指定之 URI 所識別的資源。 這個方法不會封鎖呼叫執行緒,而且允許呼叫端將物件傳遞給作業完成時所叫用的方法。 |
UploadValuesAsync(Uri, NameValueCollection)
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
將指定之名稱/值集合中的資料上載至由指定之 URI 識別的資源。 這個方法不會封鎖呼叫執行緒。
public:
void UploadValuesAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public void UploadValuesAsync (Uri address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesAsync : Uri * System.Collections.Specialized.NameValueCollection -> unit
Public Sub UploadValuesAsync (address As Uri, data As NameValueCollection)
參數
- address
- Uri
要接收集合之資源的 URI。 這個 URI 必須識別出可以接受以預設方法傳送之要求的資源。
- data
- NameValueCollection
要傳送至資源的 NameValueCollection。
例外狀況
備註
這個方法會將字串傳送至資源。 字串會使用從線程集區自動配置的線程資源,以異步方式傳送。 上傳字串之前,這個方法會使用 屬性中指定的Encoding編碼,將它Byte轉換成陣列。 若要在字串上傳完成時收到通知,您可以將事件處理程式新增至 UploadStringCompleted 事件。
這個方法不會在傳送字串時封鎖呼叫線程。 若要在等候伺服器的回應時傳送字串和區塊,請使用其中 UploadString 一種方法。
在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 方法來取消尚未完成的CancelAsync異步操作。
BaseAddress如果屬性不是空字串 (“”) 且address
不包含絕對 URI,address
則必須是結合BaseAddress的相對 URI,才能形成所要求數據的絕對 URI。 QueryString如果屬性不是空字串,則會附加至 address
。
此方法會使用 STOR 命令來上傳 FTP 資源。 針對 HTTP 資源,會使用 POST 方法。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱 .NET Framework 中的網路追蹤。
這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 UploadValues(Uri, NameValueCollection)例外狀況。
適用於
UploadValuesAsync(Uri, String, NameValueCollection)
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
使用指定的方法,將指定之名稱/值集合中的資料上載至由指定之 URI 所識別的資源。 這個方法不會封鎖呼叫執行緒。
public:
void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);
public void UploadValuesAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> unit
Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection)
參數
- address
- Uri
要接收集合之資源的 URI。 這個 URI 必須識別出可以接受以 method
方法傳送之要求的資源。
- method
- String
將字串傳送至資源時所使用的方法。 如果是 Null,預設的 HTTP 為 POST,而 FTP 則為 STOR。
- data
- NameValueCollection
要傳送至資源的 NameValueCollection。
例外狀況
備註
這個方法會將 中包含的 NameValueCollection 數據傳送至 address
資源。 使用這個方法可將表單資料傳送至 URI 進行處理。 數據會使用表單 urlencoded 媒體類型來傳送;Content-Type 標頭值必須設定為 “application/x-www-form-urlencoded”。 標頭預設會正確設定。 UploadValuesAsync如果您呼叫這個方法時,方法會在集合中Headers設定不同的 Content-Type 標頭值時擲WebException回 。
method
如果伺服器無法瞭解方法,基礎通訊協定類別會決定會發生什麼情況。 一般而言, WebException 會擲回 Status 屬性集來表示錯誤。
會 NameValueCollection 使用從線程集區自動設定的線程資源,以異步方式傳送 。 若要在上傳作業完成時收到通知,請將事件處理程式新增至 UploadValuesCompleted 事件。
這個方法不會在傳送字串時封鎖呼叫線程。 若要在等候伺服器的回應時傳送字串和區塊,請使用其中 UploadValues 一種方法。
在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 方法來取消尚未完成的CancelAsync異步操作。
BaseAddress如果屬性不是空字串 (“”) 且address
不包含絕對 URI,address
則必須是結合BaseAddress的相對 URI,才能形成所要求數據的絕對 URI。 如果屬性不是空的 QueryString ,則會附加至 address
。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱 .NET Framework 中的網路追蹤。
這個方法會儲存在工作中,它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中,則會在等候工作時擲回該例外狀況。 使用例外狀況,例如 ArgumentException仍會同步擲回。 如需預存例外狀況,請參閱 擲回的 UploadValues(Uri, String, NameValueCollection)例外狀況。
適用於
UploadValuesAsync(Uri, String, NameValueCollection, Object)
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
使用指定的方法,將指定之名稱/值集合中的資料上載至由指定之 URI 所識別的資源。 這個方法不會封鎖呼叫執行緒,而且允許呼叫端將物件傳遞給作業完成時所叫用的方法。
public:
void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data, System::Object ^ userToken);
public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data, object? userToken);
public void UploadValuesAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data, object userToken);
member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection * obj -> unit
Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection, userToken As Object)
參數
- address
- Uri
要接收集合之資源的 URI。 這個 URI 必須識別出可以接受以 method
方法傳送之要求的資源。
- method
- String
將字串傳送至資源時所使用的 HTTP 方法。 如果是 Null,預設的 HTTP 為 POST,而 FTP 則為 STOR。
- data
- NameValueCollection
要傳送至資源的 NameValueCollection。
- userToken
- Object
使用者定義的物件,這個物件會在非同步作業完成時傳遞至叫用的方法。
例外狀況
備註
這個方法會將 中包含的 NameValueCollection 數據傳送至 address
資源。 使用這個方法可將表單資料傳送至 URI 進行處理。 數據會使用表單 urlencoded 媒體類型來傳送;Content-Type 標頭值必須設定為 “application/x-www-form-urlencoded”。 標頭預設會正確設定。 UploadValuesAsync如果您呼叫這個方法時,方法會在集合中Headers設定不同的 Content-Type 標頭值時擲WebException回 。
method
如果伺服器無法瞭解方法,基礎通訊協定類別會決定會發生什麼情況。 一般而言, WebException 會擲回 Status 屬性集來表示錯誤。
會 NameValueCollection 使用從線程集區自動設定的線程資源,以異步方式傳送 。 若要在上傳作業完成時收到通知,請將事件處理程式新增至 UploadValuesCompleted 事件。
這個方法不會在傳送字串時封鎖呼叫線程。 若要在等候伺服器的回應時傳送字串和區塊,請使用其中 UploadValues 一種方法。
在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 方法來取消尚未完成的CancelAsync異步操作。
BaseAddress如果屬性不是空字串 (“”) 且address
不包含絕對 URI,address
則必須是結合BaseAddress的相對 URI,才能形成所要求數據的絕對 URI。 如果屬性不是空的 QueryString ,則會附加至 address
。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱 .NET Framework 中的網路追蹤。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應