WebClient.OpenWriteTaskAsync 方法

參考

定義

命名空間:: System.Net

組件:: System.Net.WebClient.dll

組件:: System.dll

組件:: netstandard.dll

重要

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

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

多載

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

OpenWriteTaskAsync(String)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: 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);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
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。

屬性: ComVisibleAttribute

例外狀況

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)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: WebClient.cs

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

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

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

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
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。

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

開啟資料流時發生錯誤。

備註

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

這個方法會擷 Stream 取用來將數據寫入參數所 address 指定資源的實例。數據流是使用從線程集區自動配置的線程資源來取得。

注意

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

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

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

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

適用於

OpenWriteTaskAsync(String, String)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: 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);

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

[System.Runtime.InteropServices.ComVisible(false)]
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>

[<System.Runtime.InteropServices.ComVisible(false)>]
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。

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

開啟資料流時發生錯誤。

備註

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

這個方法會擷 Stream 取用來將數據寫入參數所 address 指定資源的實例。數據流是使用從線程集區自動配置的線程資源來取得。

注意

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

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

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

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

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

另請參閱

Stream

適用於

OpenWriteTaskAsync(Uri, String)

來源:: WebClient.cs

來源:: WebClient.cs

來源:: 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);

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

[System.Runtime.InteropServices.ComVisible(false)]
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>

[<System.Runtime.InteropServices.ComVisible(false)>]
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。

屬性: ComVisibleAttribute

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

開啟資料流時發生錯誤。

備註

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

這個方法會擷 Stream 取用來將數據寫入參數所 address 指定資源的實例。數據流是使用從線程集區自動配置的線程資源來取得。

注意

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

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

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

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

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

另請參閱

Stream

適用於

共用方式為

WebClient.OpenWriteTaskAsync 方法

定義

多載

OpenWriteTaskAsync(String)

參數

傳回

例外狀況

備註

另請參閱

適用於

OpenWriteTaskAsync(Uri)

參數

傳回

例外狀況

備註

適用於

OpenWriteTaskAsync(String, String)

參數

傳回

例外狀況

備註

另請參閱

適用於

OpenWriteTaskAsync(Uri, String)

參數

傳回

例外狀況

備註

另請參閱

適用於

意見反應

其他資源