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 無法用來傳送內容。

-或-

裝載資源的伺服器沒有回應。

-或-

開啟數據流時發生錯誤。

-或-

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

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。 請改用 HttpClient。

此作業不會封鎖。 傳回 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 無效。

-或-

裝載資源的伺服器沒有回應。

-或-

開啟數據流時發生錯誤。

-或-

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

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。 請改用 HttpClient。

此作業不會封鎖。 傳回 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 無效。

-或-

開啟數據流時發生錯誤。

-或-

裝載資源的伺服器沒有回應。

-或-

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

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。 請改用 HttpClient。

此作業不會封鎖。 傳回 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 無法用來傳送內容。

-或-

裝載資源的伺服器沒有回應。

-或-

開啟數據流時發生錯誤。

-或-

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

備註

謹慎

WebRequest、HttpWebRequest、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。 請改用 HttpClient。

此作業不會封鎖。 傳回 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 中的網路追蹤。