WebClient.UploadStringAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

將指定的字串上傳至指定的資源。 這些方法不會封鎖呼叫線程。

多載

UploadStringAsync(Uri, String)	將指定的字串上傳至指定的資源。 這個方法不會封鎖呼叫線程。
UploadStringAsync(Uri, String, String)	將指定的字串上傳至指定的資源。 這個方法不會封鎖呼叫線程。
UploadStringAsync(Uri, String, String, Object)	將指定的字串上傳至指定的資源。 這個方法不會封鎖呼叫線程。

UploadStringAsync(Uri, String)

來源:

WebClient.cs

將指定的字串上傳至指定的資源。 這個方法不會封鎖呼叫線程。

public:
 void UploadStringAsync(Uri ^ address, System::String ^ data);

public void UploadStringAsync (Uri address, string data);

member this.UploadStringAsync : Uri * string -> unit

Public Sub UploadStringAsync (address As Uri, data As String)

參數

address

Uri

要接收字串之資源的 URI。 針對 HTTP 資源，此 URI 必須識別可接受 POST 方法所傳送要求的資源，例如腳本或 ASP 頁面。

data

String

要上傳的字串。

例外狀況

ArgumentNullException

address 參數是 null。

-或-

data 參數是 null。

WebException

結合 BaseAddress 和 address 所形成的 URI 無效。

-或-

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

備註

謹慎

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

這個方法會將字串傳送至資源。 字串會使用從線程集區自動配置的線程資源，以異步方式傳送。 上傳字串之前，這個方法會使用 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，仍會同步擲回。 如需預存的例外狀況，請參閱 UploadString(Uri, String)擲回的例外狀況。

UploadStringAsync(Uri, String, String)

來源:

WebClient.cs

將指定的字串上傳至指定的資源。 這個方法不會封鎖呼叫線程。

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data);

public void UploadStringAsync (Uri address, string? method, string data);

member this.UploadStringAsync : Uri * string * string -> unit

Public Sub UploadStringAsync (address As Uri, method As String, data As String)

參數

address

Uri

要接收字串之資源的 URI。 針對 HTTP 資源，此 URI 必須識別可接受 POST 方法所傳送要求的資源，例如腳本或 ASP 頁面。

method

String

用來將檔案傳送至資源的 HTTP 方法。 如果為 null，則預設值為 HTTP 的 POST，而 FTP 則為 STOR。

data

String

要上傳的字串。

例外狀況

ArgumentNullException

address 參數是 null。

-或-

data 參數是 null。

WebException

結合 BaseAddress 和 address 所形成的 URI 無效。

-或-

method 無法用來傳送內容。

-或-

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

備註

謹慎

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

這個方法會將字串傳送至資源。 字串會使用從線程集區自動配置的線程資源，以異步方式傳送。 上傳字串之前，這個方法會使用 Encoding 屬性中指定的編碼，將它轉換成 Byte 陣列。 若要在字串上傳完成時接收通知，您可以將事件處理程式新增至 UploadStringCompleted 事件。

此方法不會在傳送字串時封鎖呼叫線程。 若要在等候伺服器的回應時傳送字串和區塊，請使用其中一個 UploadString 方法。

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

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

注意

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

這個方法會儲存在工作中，它會傳回方法同步對應項可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException，仍會同步擲回。 如需預存的例外狀況，請參閱 UploadString(Uri, String, String)擲回的例外狀況。

UploadStringAsync(Uri, String, String, Object)

來源:

WebClient.cs

將指定的字串上傳至指定的資源。 這個方法不會封鎖呼叫線程。

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data, System::Object ^ userToken);

public void UploadStringAsync (Uri address, string? method, string data, object? userToken);

member this.UploadStringAsync : Uri * string * string * obj -> unit

Public Sub UploadStringAsync (address As Uri, method As String, data As String, userToken As Object)

參數

address

Uri

要接收字串之資源的 URI。 針對 HTTP 資源，此 URI 必須識別可接受 POST 方法所傳送要求的資源，例如腳本或 ASP 頁面。

method

String

用來將檔案傳送至資源的 HTTP 方法。 如果為 null，則預設值為 HTTP 的 POST，而 FTP 則為 STOR。

data

String

要上傳的字串。

userToken

Object

使用者定義對象，傳遞至異步操作完成時叫用的方法。

例外狀況

ArgumentNullException

address 參數是 null。

-或-

data 參數是 null。

WebException

結合 BaseAddress 和 address 所形成的 URI 無效。

-或-

method 無法用來傳送內容。

-或-

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

備註

謹慎

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

這個方法會將字串傳送至資源。 字串會使用從線程集區自動配置的線程資源，以異步方式傳送。 上傳字串之前，這個方法會使用 Encoding 屬性中指定的編碼，將它轉換成 Byte 陣列。 若要在字串上傳完成時接收通知，您可以將事件處理程式新增至 UploadStringCompleted 事件。

此方法不會在傳送字串時封鎖呼叫線程。 若要在等候伺服器的回應時傳送字串和區塊，請使用其中一個 UploadString 方法。

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

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

注意

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