WebClient.OpenWriteAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

開啟資料流以將資料寫入至指定的資源。 這些方法不會封鎖呼叫執行緒。

多載

OpenWriteAsync(Uri, String, Object)	使用指定的方法開啟資料流，以將資料寫入至指定的資源。 這個方法不會封鎖呼叫執行緒。
OpenWriteAsync(Uri, String)	開啟資料流以將資料寫入至指定的資源。 這個方法不會封鎖呼叫執行緒。
OpenWriteAsync(Uri)	開啟資料流以將資料寫入至指定的資源。 這個方法不會封鎖呼叫執行緒。

OpenWriteAsync(Uri, String, Object)

來源:

WebClient.cs

使用指定的方法開啟資料流，以將資料寫入至指定的資源。 這個方法不會封鎖呼叫執行緒。

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

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

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

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

參數

address

Uri

要接收資料之資源的 URI。

method

String

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

userToken

Object

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

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

開啟資料流時發生錯誤。

備註

這個方法會擷取用來將數據傳送至資源的可寫入數據流。 數據流會使用從線程集區自動配置的線程資源，以異步方式擷取。 若要在數據流可用時接收通知，請將事件處理程式新增至 OpenWriteCompleted 事件。 當您關閉數據流時，數據流的內容會傳送至伺服器。

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

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

這個方法不會在開啟數據流時封鎖呼叫線程。 若要在等候數據流時封鎖，請使用其中 OpenWrite 一種方法。

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

注意

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

OpenWriteAsync(Uri, String)

來源:

WebClient.cs

開啟資料流以將資料寫入至指定的資源。 這個方法不會封鎖呼叫執行緒。

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

public void OpenWriteAsync (Uri address, string? method);

member this.OpenWriteAsync : Uri * string -> unit

Public Sub OpenWriteAsync (address As Uri, method As String)

參數

address

Uri

要接收資料之資源的 URI。

method

String

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

例外狀況

ArgumentNullException

address 參數為 null。

備註

這個方法會擷取用來將數據傳送至資源的可寫入數據流。 數據流是使用從線程集區自動配置的線程資源來擷取。 若要在數據流可用時接收通知，請將事件處理程式新增至 OpenWriteCompleted 事件。 當您關閉數據流時，線程會封鎖，直到傳送 address 要求並收到響應為止。

這個方法不會在開啟數據流時封鎖呼叫線程。 若要在等候數據流時封鎖，請使用其中 OpenWrite 一種方法。

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

注意

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

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

OpenWriteAsync(Uri)

來源:

WebClient.cs

開啟資料流以將資料寫入至指定的資源。 這個方法不會封鎖呼叫執行緒。

public:
 void OpenWriteAsync(Uri ^ address);

public void OpenWriteAsync (Uri address);

member this.OpenWriteAsync : Uri -> unit

Public Sub OpenWriteAsync (address As Uri)

參數

address

Uri

要接收資料之資源的 URI。

例外狀況

ArgumentNullException

address 參數為 null。

備註

這個方法會擷取用來將數據傳送至資源的可寫入數據流。 數據流是使用從線程集區自動配置的線程資源來擷取。 若要在數據流可用時接收通知，請將事件處理程式新增至 OpenWriteCompleted 事件。 當您關閉數據流時，線程會封鎖，直到傳送 address 要求並收到響應為止。

這個方法不會在開啟數據流時封鎖呼叫線程。 若要在等候數據流時封鎖，請使用其中 OpenWrite 一種方法。

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

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

注意

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

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