WebClient.UploadDataTaskAsync 方法

定義

使用工作物件,以非同步作業的方式,將包含 Byte 陣列的資料緩衝區上傳至指定的 URI。 這些方法不會封鎖呼叫執行緒。

多載

UploadDataTaskAsync(String, Byte[])

使用工作物件,以非同步作業的方式,將包含 Byte 陣列的資料緩衝區上傳至指定的 URI。

UploadDataTaskAsync(Uri, Byte[])

使用工作物件,以非同步作業的方式,將包含 Byte 陣列的資料緩衝區上傳至指定的 URI。

UploadDataTaskAsync(String, String, Byte[])

使用工作物件,以非同步作業的方式,將包含 Byte 陣列的資料緩衝區上傳至指定的 URI。

UploadDataTaskAsync(Uri, String, Byte[])

使用工作物件,以非同步作業的方式,將包含 Byte 陣列的資料緩衝區上傳至指定的 URI。

UploadDataTaskAsync(String, Byte[])

使用工作物件,以非同步作業的方式,將包含 Byte 陣列的資料緩衝區上傳至指定的 URI。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, cli::array <System::Byte> ^ data);
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, byte[] data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, byte[] data);
member this.UploadDataTaskAsync : string * byte[] -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : string * byte[] -> System.Threading.Tasks.Task<byte[]>
Public Function UploadDataTaskAsync (address As String, data As Byte()) As Task(Of Byte())

參數

address
String

要接收資料之資源的 URI。

data
Byte[]

要傳送至資源的資料緩衝區。

傳回

Task<Byte[]>

工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回包含上傳資料緩衝區時接收自資源之回應主體的 Byte 陣列。

屬性

例外狀況

address 參數為 null

合併 BaseAddressaddress 而形成的 URI 是無效的。

-或-

開啟資料流時發生錯誤。

-或-

沒有來自裝載 (Host) 資源之伺服器的回應。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在資料緩衝區上傳至資源之後完成。

這個方法會將資料緩衝區傳送至資源。 資料緩衝區會使用從執行緒集區自動設定的執行緒資源,以非同步方式傳送。 資料未編碼。

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

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

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

注意

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

適用於

UploadDataTaskAsync(Uri, Byte[])

使用工作物件,以非同步作業的方式,將包含 Byte 陣列的資料緩衝區上傳至指定的 URI。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, cli::array <System::Byte> ^ data);
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, byte[] data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, byte[] data);
member this.UploadDataTaskAsync : Uri * byte[] -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : Uri * byte[] -> System.Threading.Tasks.Task<byte[]>
Public Function UploadDataTaskAsync (address As Uri, data As Byte()) As Task(Of Byte())

參數

address
Uri

要接收資料之資源的 URI。

data
Byte[]

要傳送至資源的資料緩衝區。

傳回

Task<Byte[]>

工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回包含上傳資料緩衝區時接收自資源之回應主體的 Byte 陣列。

屬性

例外狀況

address 參數為 null

合併 BaseAddressaddress 而形成的 URI 是無效的。

-或-

開啟資料流時發生錯誤。

-或-

沒有來自裝載 (Host) 資源之伺服器的回應。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在資料緩衝區上傳至資源之後完成。

這個方法會將資料緩衝區傳送至資源。 資料緩衝區會使用從執行緒集區自動設定的執行緒資源,以非同步方式傳送。 資料未編碼。

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

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

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

注意

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

適用於

UploadDataTaskAsync(String, String, Byte[])

使用工作物件,以非同步作業的方式,將包含 Byte 陣列的資料緩衝區上傳至指定的 URI。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, string? method, byte[] data);
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, string method, byte[] data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, string method, byte[] data);
member this.UploadDataTaskAsync : string * string * byte[] -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : string * string * byte[] -> System.Threading.Tasks.Task<byte[]>
Public Function UploadDataTaskAsync (address As String, method As String, data As Byte()) As Task(Of Byte())

參數

address
String

要接收資料之資源的 URI。

method
String

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

data
Byte[]

要傳送至資源的資料緩衝區。

傳回

Task<Byte[]>

工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回包含上傳資料緩衝區時接收自資源之回應主體的 Byte 陣列。

屬性

例外狀況

address 參數為 null

合併 BaseAddressaddress 而形成的 URI 是無效的。

-或-

開啟資料流時發生錯誤。

-或-

沒有來自裝載 (Host) 資源之伺服器的回應。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在資料緩衝區上傳至資源之後完成。

這個方法會將資料緩衝區傳送至資源。 資料緩衝區會使用從執行緒集區自動設定的執行緒資源,以非同步方式傳送。 資料未編碼。

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

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

注意

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

適用於

UploadDataTaskAsync(Uri, String, Byte[])

使用工作物件,以非同步作業的方式,將包含 Byte 陣列的資料緩衝區上傳至指定的 URI。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, string? method, byte[] data);
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, string method, byte[] data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, string method, byte[] data);
member this.UploadDataTaskAsync : Uri * string * byte[] -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : Uri * string * byte[] -> System.Threading.Tasks.Task<byte[]>
Public Function UploadDataTaskAsync (address As Uri, method As String, data As Byte()) As Task(Of Byte())

參數

address
Uri

要接收資料之資源的 URI。

method
String

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

data
Byte[]

要傳送至資源的資料緩衝區。

傳回

Task<Byte[]>

工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回包含上傳資料緩衝區時接收自資源之回應主體的 Byte 陣列。

屬性

例外狀況

address 參數為 null

合併 BaseAddressaddress 而形成的 URI 是無效的。

-或-

開啟資料流時發生錯誤。

-或-

沒有來自裝載 (Host) 資源之伺服器的回應。

備註

這項作業不會封鎖。 傳回 Task<TResult> 的物件會在資料緩衝區上傳至資源之後完成。

這個方法會將資料緩衝區傳送至資源。 資料緩衝區會使用從執行緒集區自動設定的執行緒資源,以非同步方式傳送。 資料未編碼。

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

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

注意

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

適用於