WebClient.UploadValuesAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

將指定的名稱/值集合上載至由指定之 URI 所識別的資源。 這些方法不會封鎖呼叫執行緒。

多載

UploadValuesAsync(Uri, NameValueCollection)	將指定之名稱/值集合中的資料上載至由指定之 URI 識別的資源。 這個方法不會封鎖呼叫執行緒。
UploadValuesAsync(Uri, String, NameValueCollection)	使用指定的方法，將指定之名稱/值集合中的資料上載至由指定之 URI 所識別的資源。 這個方法不會封鎖呼叫執行緒。
UploadValuesAsync(Uri, String, NameValueCollection, Object)	使用指定的方法，將指定之名稱/值集合中的資料上載至由指定之 URI 所識別的資源。 這個方法不會封鎖呼叫執行緒，而且允許呼叫端將物件傳遞給作業完成時所叫用的方法。

UploadValuesAsync(Uri, NameValueCollection)

來源:

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。

例外狀況

ArgumentNullException

address 參數為 null。

-或-

data 參數為 null。

WebException

合併 BaseAddress 和 address 而形成的 URI 是無效的。

-或-

沒有來自裝載 (Host) 資源之伺服器的回應。

備註

這個方法會將字串傳送至資源。 字串會使用從執行緒集區自動設定的執行緒資源，以非同步方式傳送。 上傳字串之前，這個方法會使用 屬性中指定的 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

使用指定的方法，將指定之名稱/值集合中的資料上載至由指定之 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);

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。

例外狀況

ArgumentNullException

address 參數為 null。

-或-

data 參數為 null。

WebException

合併 BaseAddress 和 address 而形成的 URI 是無效的。

-或-

沒有來自裝載 (Host) 資源之伺服器的回應。

-或-

無法使用 method 傳送內容。

備註

這個方法會將 中包含的 NameValueCollection 資料傳送至 address 資源。 使用這個方法可將表單資料傳送至 URI 進行處理。 資料會使用表單 URLencoded 媒體類型傳送;Content-Type 標頭值必須設定為 「application/x-www-form-urlencoded」。 標頭預設會正確設定。 如果您使用集合中 Headers 設定的不同 Content-Type 標頭值呼叫此方法，則 UploadValuesAsync 方法會擲 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

使用指定的方法，將指定之名稱/值集合中的資料上載至由指定之 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);

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

使用者定義的物件，這個物件會在非同步作業完成時傳遞至叫用的方法。

例外狀況

ArgumentNullException

address 參數為 null。

-或-

data 參數為 null。

WebException

合併 BaseAddress 和 address 而形成的 URI 是無效的。

-或-

沒有來自裝載 (Host) 資源之伺服器的回應。

-或-

無法使用 method 傳送內容。

備註

這個方法會將 中包含的 NameValueCollection 資料傳送至 address 資源。 使用這個方法可將表單資料傳送至 URI 進行處理。 資料會使用表單 URLencoded 媒體類型傳送;Content-Type 標頭值必須設定為 「application/x-www-form-urlencoded」。 標頭預設會正確設定。 如果您使用集合中 Headers 設定的不同 Content-Type 標頭值呼叫此方法，則 UploadValuesAsync 方法會擲 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 中的網路追蹤。