WebClient.UploadStringTaskAsync 方法

參考

定義

命名空間:: System.Net

組件:: System.Net.WebClient.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

使用工作物件，以非同步作業的方式將指定的字串上傳至指定的資源。這些方法不會封鎖呼叫執行緒。

多載

UploadStringTaskAsync(Uri, String, String)	使用工作物件，以非同步作業的方式將指定的字串上傳至指定的資源。
UploadStringTaskAsync(String, String, String)	使用工作物件，以非同步作業的方式將指定的字串上傳至指定的資源。
UploadStringTaskAsync(String, String)	使用工作物件，以非同步作業的方式將指定的字串上傳至指定的資源。
UploadStringTaskAsync(Uri, String)	使用工作物件，以非同步作業的方式將指定的字串上傳至指定的資源。

UploadStringTaskAsync(Uri, String, String)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: WebClient.cs

使用工作物件，以非同步作業的方式將指定的字串上傳至指定的資源。

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string? method, string data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string method, string data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string method, string data);

member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, method As String, data As String) As Task(Of String)

參數

address: Uri

要接收字串之資源的 URI。對於 HTTP 資源而言，這個 URI 必須識別出可以接受使用 POST 方法傳送之要求的資源，例如指令碼或 ASP 網頁。

method: String

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

data: String

要上傳的字串。

傳回

Task<String>

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

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

address 參數為 null。

-或-

data 參數為 null。

WebException

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

-或-

無法使用 method 傳送內容。

-或-

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

備註

這項作業不會封鎖。傳回 Task<TResult> 的物件會在字串上傳至資源之後完成。字串會使用從線程集區自動配置的線程資源，以異步方式傳送。

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

上傳字串之前，這個方法會使用屬性中指定的Encoding編碼，將它Byte轉換成陣列。這個方法會在傳輸字串時封鎖。

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

注意

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

適用於

UploadStringTaskAsync(String, String, String)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: WebClient.cs

使用工作物件，以非同步作業的方式將指定的字串上傳至指定的資源。

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string? method, string data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string method, string data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string method, string data);

member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, method As String, data As String) As Task(Of String)

參數

address: String

要接收字串之資源的 URI。對於 HTTP 資源而言，這個 URI 必須識別出可以接受使用 POST 方法傳送之要求的資源，例如指令碼或 ASP 網頁。

method: String

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

data: String

要上傳的字串。

傳回

Task<String>

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

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

address 參數為 null。

-或-

data 參數為 null。

WebException

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

-或-

無法使用 method 傳送內容。

-或-

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

備註

這項作業不會封鎖。傳回 Task<TResult> 的物件會在字串上傳至資源之後完成。字串會使用從線程集區自動配置的線程資源，以異步方式傳送。

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

上傳字串之前，這個方法會使用屬性中指定的Encoding編碼，將它Byte轉換成陣列。這個方法會在傳輸字串時封鎖。

注意

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

適用於

UploadStringTaskAsync(String, String)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: WebClient.cs

使用工作物件，以非同步作業的方式將指定的字串上傳至指定的資源。

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);

member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, data As String) As Task(Of String)

參數

address: String

要接收字串之資源的 URI。對於 HTTP 資源而言，這個 URI 必須識別出可以接受使用 POST 方法傳送之要求的資源，例如指令碼或 ASP 網頁。

data: String

要上傳的字串。

傳回

Task<String>

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

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

address 參數為 null。

-或-

data 參數為 null。

WebException

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

-或-

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

備註

這項作業不會封鎖。傳回 Task<TResult> 的物件會在字串上傳至資源之後完成。字串會使用從線程集區自動配置的線程資源，以異步方式傳送。

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

上傳字串之前，這個方法會使用屬性中指定的Encoding編碼，將它Byte轉換成陣列。這個方法會在傳輸字串時封鎖。

注意

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

適用於

UploadStringTaskAsync(Uri, String)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: WebClient.cs

使用工作物件，以非同步作業的方式將指定的字串上傳至指定的資源。

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);

member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, data As String) As Task(Of String)

參數

address: Uri

要接收字串之資源的 URI。對於 HTTP 資源而言，這個 URI 必須識別出可以接受使用 POST 方法傳送之要求的資源，例如指令碼或 ASP 網頁。

data: String

要上傳的字串。

傳回

Task<String>

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

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

address 參數為 null。

-或-

data 參數為 null。

WebException

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

-或-

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

備註

這項作業不會封鎖。傳回 Task<TResult> 的物件會在字串上傳至資源之後完成。字串會使用從線程集區自動配置的線程資源，以異步方式傳送。

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

上傳字串之前，這個方法會使用屬性中指定的Encoding編碼，將它Byte轉換成陣列。這個方法會在傳輸字串時封鎖。

注意

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

適用於

WebClient.UploadStringTaskAsync 方法

定義

多載

UploadStringTaskAsync(Uri, String, String)

參數

傳回

例外狀況

備註

適用於

UploadStringTaskAsync(String, String, String)

參數

傳回

例外狀況

備註

適用於

UploadStringTaskAsync(String, String)

參數

傳回

例外狀況

備註

適用於

UploadStringTaskAsync(Uri, String)

參數

傳回

例外狀況

備註

適用於

意見反應

其他資源