WebClient.OpenWriteTaskAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

開啟數據流，以使用工作對象將數據寫入指定的資源做為異步操作。 這些方法不會封鎖呼叫線程。

多載

OpenWriteTaskAsync(String)	開啟數據流，以使用工作對象將數據寫入指定的資源做為異步操作。
OpenWriteTaskAsync(Uri)	開啟數據流，以使用工作對象將數據寫入指定的資源做為異步操作。
OpenWriteTaskAsync(String, String)	開啟數據流，以使用工作對象將數據寫入指定的資源做為異步操作。
OpenWriteTaskAsync(Uri, String)	開啟數據流，以使用工作對象將數據寫入指定的資源做為異步操作。

OpenWriteTaskAsync(String)

來源:

WebClient.cs

開啟數據流，以使用工作對象將數據寫入指定的資源做為異步操作。

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 無效。

-或-

開啟數據流時發生錯誤。

備註

謹慎

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

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

來源:

WebClient.cs

開啟數據流，以使用工作對象將數據寫入指定的資源做為異步操作。

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 無效。

-或-

開啟數據流時發生錯誤。

備註

謹慎

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

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

來源:

WebClient.cs

開啟數據流，以使用工作對象將數據寫入指定的資源做為異步操作。

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 無效。

-或-

開啟數據流時發生錯誤。

備註

謹慎

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

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

來源:

WebClient.cs

開啟數據流，以使用工作對象將數據寫入指定的資源做為異步操作。

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 無效。

-或-

開啟數據流時發生錯誤。

備註

謹慎

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

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