WebClient.UploadDataTaskAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
使用工作物件,以非同步作業的方式,將包含 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[]
要傳送至資源的資料緩衝區。
傳回
工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回包含上傳資料緩衝區時接收自資源之回應主體的 Byte 陣列。
- 屬性
例外狀況
address
參數為 null
。
備註
這項作業不會封鎖。 傳回 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[]
要傳送至資源的資料緩衝區。
傳回
工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回包含上傳資料緩衝區時接收自資源之回應主體的 Byte 陣列。
- 屬性
例外狀況
address
參數為 null
。
備註
這項作業不會封鎖。 傳回 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[]
要傳送至資源的資料緩衝區。
傳回
工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回包含上傳資料緩衝區時接收自資源之回應主體的 Byte 陣列。
- 屬性
例外狀況
address
參數為 null
。
備註
這項作業不會封鎖。 傳回 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[]
要傳送至資源的資料緩衝區。
傳回
工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回包含上傳資料緩衝區時接收自資源之回應主體的 Byte 陣列。
- 屬性
例外狀況
address
參數為 null
。
備註
這項作業不會封鎖。 傳回 Task<TResult> 的物件會在資料緩衝區上傳至資源之後完成。
這個方法會將資料緩衝區傳送至資源。 資料緩衝區會使用從執行緒集區自動設定的執行緒資源,以非同步方式傳送。 資料未編碼。
在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 方法來取消尚未完成的 CancelAsync 非同步作業。
BaseAddress如果屬性不是空字串 (「」) ,而且 address
不包含絕對 URI, address
則必須是結合 BaseAddress 的相對 URI,才能形成所要求資料的絕對 URI。 QueryString如果屬性不是空字串,則會附加至 address
。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱.NET Framework 中的網路追蹤。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將推出:在 2024 年,我們將隨著內容的意見反應機制逐步淘汰 GitHub 問題,並以新的意見反應系統來取代。 如需詳細資訊,請參閱提交並檢視相關的意見反應