WebClient.OpenWriteTaskAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

使用工作物件，以非同步作業的方式開啟資料流，將資料寫入指定的資源。 這些方法不會封鎖呼叫執行緒。

多載

OpenWriteTaskAsync(String)	使用工作物件，以非同步作業的方式開啟資料流，將資料寫入指定的資源。
OpenWriteTaskAsync(Uri)	使用工作物件，以非同步作業的方式開啟資料流，將資料寫入指定的資源。
OpenWriteTaskAsync(String, String)	使用工作物件，以非同步作業的方式開啟資料流，將資料寫入指定的資源。
OpenWriteTaskAsync(Uri, String)	使用工作物件，以非同步作業的方式開啟資料流，將資料寫入指定的資源。

OpenWriteTaskAsync(String)

使用工作物件，以非同步作業的方式開啟資料流，將資料寫入指定的資源。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);

member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)

參數

address

String

要接收資料之資源的 URI。

傳回

Task<Stream>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回用來將資料寫入資源的 Stream。

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

開啟資料流時發生錯誤。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在開啟資料資源的可寫入資料流程之後完成。 這個方法不會在資料流程開啟時封鎖呼叫執行緒。

這個方法會擷 Stream 取實例，用來將資料寫入參數所 address 指定的資源。 資料流程是使用從執行緒集區自動設定的執行緒資源來取得。

注意

當您完成 Stream 時必須呼叫 Stream.Close ，以避免系統資源用盡。

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

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

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

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

另請參閱

• Stream

OpenWriteTaskAsync(Uri)

使用工作物件，以非同步作業的方式開啟資料流，將資料寫入指定的資源。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);

member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)

參數

address

Uri

要接收資料之資源的 URI。

傳回

Task<Stream>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回用來將資料寫入資源的 Stream。

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

開啟資料流時發生錯誤。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在開啟資料資源的可寫入資料流程之後完成。 這個方法不會在資料流程開啟時封鎖呼叫執行緒。

這個方法會擷 Stream 取實例，用來將資料寫入參數所 address 指定的資源。 資料流程是使用從執行緒集區自動設定的執行緒資源來取得。

注意

當您完成 Stream 時必須呼叫 Stream.Close ，以避免系統資源用盡。

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

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

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

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

OpenWriteTaskAsync(String, String)

使用工作物件，以非同步作業的方式開啟資料流，將資料寫入指定的資源。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address, System::String ^ method);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string? method);

member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As String, method As String) As Task(Of Stream)

參數

address

String

要接收資料之資源的 URI。

method

String

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

傳回

Task<Stream>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回用來將資料寫入資源的 Stream。

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

開啟資料流時發生錯誤。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在開啟資料資源的可寫入資料流程之後完成。 這個方法不會在資料流程開啟時封鎖呼叫執行緒。

這個方法會擷 Stream 取實例，用來將資料寫入參數所 address 指定的資源。 資料流程是使用從執行緒集區自動設定的執行緒資源來取得。

注意

當您完成 Stream 時必須呼叫 Stream.Close ，以避免系統資源用盡。

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

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

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

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

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

另請參閱

• Stream

OpenWriteTaskAsync(Uri, String)

使用工作物件，以非同步作業的方式開啟資料流，將資料寫入指定的資源。

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address, System::String ^ method);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string? method);

member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As Uri, method As String) As Task(Of Stream)

參數

address

Uri

要接收資料之資源的 URI。

method

String

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

傳回

Task<Stream>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回用來將資料寫入資源的 Stream。

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

開啟資料流時發生錯誤。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在開啟資料資源的可寫入資料流程之後完成。 這個方法不會在資料流程開啟時封鎖呼叫執行緒。

這個方法會擷 Stream 取實例，用來將資料寫入參數所 address 指定的資源。 資料流程是使用從執行緒集區自動設定的執行緒資源來取得。

注意

當您完成 Stream 時必須呼叫 Stream.Close ，以避免系統資源用盡。

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

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

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

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

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

另請參閱

• Stream