WebClient.UploadValuesTaskAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

使用工作物件，以非同步作業的方式將指定的名稱/值集合上傳至指定之 URI 所識別的資源。 這些方法不會封鎖呼叫執行緒。

多載

UploadValuesTaskAsync(String, String, NameValueCollection)	使用工作物件，以非同步作業的方式將指定的名稱/值集合上傳至指定之 URI 所識別的資源。
UploadValuesTaskAsync(String, NameValueCollection)	使用工作物件，以非同步作業的方式將指定的名稱/值集合上傳至指定之 URI 所識別的資源。
UploadValuesTaskAsync(Uri, NameValueCollection)	使用工作物件，以非同步作業的方式將指定的名稱/值集合上傳至指定之 URI 所識別的資源。
UploadValuesTaskAsync(Uri, String, NameValueCollection)	使用工作物件，以非同步作業的方式將指定的名稱/值集合上傳至指定之 URI 所識別的資源。

UploadValuesTaskAsync(String, String, NameValueCollection)

來源:

WebClient.cs

使用工作物件，以非同步作業的方式將指定的名稱/值集合上傳至指定之 URI 所識別的資源。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, method As String, data As NameValueCollection) As Task(Of Byte())

參數

address

String

要接收集合之資源的 URI。

method

String

傳送集合給資源所使用的 HTTP 方法。 如果是 Null，預設的 HTTP 為 POST，而 FTP 則為 STOR。

data

NameValueCollection

要傳送至資源的 NameValueCollection。

傳回

Task<Byte[]>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回包含伺服器所傳送之回應的 Byte 陣列。

例外狀況

ArgumentNullException

address 參數為 null。

-或-

data 參數為 null。

WebException

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

-或-

無法使用 method 傳送內容。

-或-

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

-或-

開啟資料流時發生錯誤。

-或-

Content-type 標頭不是 null 或 "application/x-www-form-urlencoded"。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在將名稱/值集合上傳至資源之後完成。 名稱/值集合會使用從執行緒集區自動設定的執行緒資源，以非同步方式傳送。

在 .NET Framework 和 .NET Core 1.0 中，您可以藉由呼叫 方法來取消尚未完成的 CancelAsync 非同步作業。

如果伺服器無法瞭解基礎要求，基礎通訊協定類別會決定會發生什麼情況。 一般而言， WebException 會擲回 ，並 Status 設定 屬性來指出錯誤。

如果 Content-type 標頭為 null ，這個方法會將它設定為 「application/x-www-form-urlencoded」。

BaseAddress如果屬性不是空字串 (「」) 且 address 不包含絕對 URI， address 則必須是結合 BaseAddress 的相對 URI，才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串，則會附加至 address 。

此方法會使用 STOR 命令來上傳 FTP 資源。 針對 HTTP 資源，會使用 POST 方法。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱.NET Framework 中的網路追蹤。

UploadValuesTaskAsync(String, NameValueCollection)

來源:

WebClient.cs

使用工作物件，以非同步作業的方式將指定的名稱/值集合上傳至指定之 URI 所識別的資源。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (string address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, data As NameValueCollection) As Task(Of Byte())

參數

address

String

要接收集合之資源的 URI。

data

NameValueCollection

要傳送至資源的 NameValueCollection。

傳回

Task<Byte[]>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回包含伺服器所傳送之回應的 Byte 陣列。

例外狀況

ArgumentNullException

address 參數為 null。

-或-

data 參數為 null。

WebException

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

-或-

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

-或-

開啟資料流時發生錯誤。

-或-

Content-type 標頭不是 null 或 "application/x-www-form-urlencoded"。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在將名稱/值集合上傳至資源之後完成。 名稱/值集合會使用從執行緒集區自動設定的執行緒資源，以非同步方式傳送。

在 .NET Framework 和 .NET Core 1.0 中，您可以藉由呼叫 方法來取消尚未完成的 CancelAsync 非同步作業。

如果伺服器無法瞭解基礎要求，基礎通訊協定類別會決定會發生什麼情況。 一般而言， WebException 會擲回 ，並 Status 設定 屬性來指出錯誤。

如果 Content-type 標頭為 null ，這個方法會將它設定為 「application/x-www-form-urlencoded」。

BaseAddress如果屬性不是空字串 (「」) 且 address 不包含絕對 URI， address 則必須是結合 BaseAddress 的相對 URI，才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串，則會附加至 address 。

此方法會使用 STOR 命令來上傳 FTP 資源。 針對 HTTP 資源，會使用 POST 方法。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱.NET Framework 中的網路追蹤。

UploadValuesTaskAsync(Uri, NameValueCollection)

來源:

WebClient.cs

使用工作物件，以非同步作業的方式將指定的名稱/值集合上傳至指定之 URI 所識別的資源。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, data As NameValueCollection) As Task(Of Byte())

參數

address

Uri

要接收集合之資源的 URI。

data

NameValueCollection

要傳送至資源的 NameValueCollection。

傳回

Task<Byte[]>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回包含伺服器所傳送之回應的 Byte 陣列。

例外狀況

ArgumentNullException

address 參數為 null。

-或-

data 參數為 null。

WebException

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

-或-

開啟資料流時發生錯誤。

-或-

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

-或-

Content-type 標頭值不是 null，也不是 application/x-www-form-urlencoded。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在將名稱/值集合上傳至資源之後完成。 名稱/值集合會使用從執行緒集區自動設定的執行緒資源，以非同步方式傳送。

在 .NET Framework 和 .NET Core 1.0 中，您可以藉由呼叫 方法來取消尚未完成的 CancelAsync 非同步作業。

如果伺服器無法瞭解基礎要求，基礎通訊協定類別會決定會發生什麼情況。 一般而言， WebException 會擲回 ，並 Status 設定 屬性來指出錯誤。

如果 Content-type 標頭為 null ，這個方法會將它設定為 「application/x-www-form-urlencoded」。

BaseAddress如果屬性不是空字串 (「」) 且 address 不包含絕對 URI， address 則必須是結合 BaseAddress 的相對 URI，才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串，則會附加至 address 。

此方法會使用 STOR 命令來上傳 FTP 資源。 針對 HTTP 資源，會使用 POST 方法。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱.NET Framework 中的網路追蹤。

UploadValuesTaskAsync(Uri, String, NameValueCollection)

來源:

WebClient.cs

使用工作物件，以非同步作業的方式將指定的名稱/值集合上傳至指定之 URI 所識別的資源。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, method As String, data As NameValueCollection) As Task(Of Byte())

參數

address

Uri

要接收集合之資源的 URI。

method

String

傳送集合給資源所使用的 HTTP 方法。 如果是 Null，預設的 HTTP 為 POST，而 FTP 則為 STOR。

data

NameValueCollection

要傳送至資源的 NameValueCollection。

傳回

Task<Byte[]>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回包含伺服器所傳送之回應的 Byte 陣列。

例外狀況

ArgumentNullException

address 參數為 null。

-或-

data 參數為 null。

WebException

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

-或-

無法使用 method 傳送內容。

-或-

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

-或-

開啟資料流時發生錯誤。

-或-

Content-type 標頭不是 null 或 "application/x-www-form-urlencoded"。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在名稱/值集合上傳至資源之後完成。 名稱/值集合會使用從執行緒集區自動設定的執行緒資源，以非同步方式傳送。

在 .NET Framework 和 .NET Core 1.0 中，您可以呼叫 方法來取消尚未完成的 CancelAsync 非同步作業。

如果伺服器無法瞭解基礎要求，基礎通訊協定類別會決定會發生什麼情況。 一般而言， WebException 會擲回 Status 屬性集來表示錯誤。

如果 Content-type 標頭為 null ，這個方法會將它設定為 「application/x-www-form-urlencoded」。

BaseAddress如果屬性不是空字串 (「」) 且 address 不包含絕對 URI， address 則必須是結合 BaseAddress 的相對 URI，才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串，則會附加至 address 。

此方法會使用 STOR 命令來上傳 FTP 資源。 針對 HTTP 資源，會使用 POST 方法。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。 如需詳細資訊，請參閱.NET Framework 中的網路追蹤。