WebClient.OpenReadTaskAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
使用工作物件,以非同步作業的方式開啟包含指定之資源的可讀取資料流。 這些方法不會封鎖呼叫執行緒。
多載
OpenReadTaskAsync(String) |
使用工作物件,以非同步作業的方式開啟包含指定之資源的可讀取資料流。 |
OpenReadTaskAsync(Uri) |
使用工作物件,以非同步作業的方式開啟包含指定之資源的可讀取資料流。 |
OpenReadTaskAsync(String)
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
使用工作物件,以非同步作業的方式開啟包含指定之資源的可讀取資料流。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)
參數
- address
- String
要擷取之資源的 URI。
傳回
工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回用來從資源讀取資料的 Stream。
- 屬性
例外狀況
address
參數為 null
。
備註
這項作業不會封鎖。 傳回 Task<TResult> 的物件會在開啟數據資源的可讀取數據流之後完成。 這個方法不會在數據流開啟時封鎖呼叫線程。
這個方法會擷 Stream 取用來存取 參數所 address
指定資源的實例。 數據流是使用從線程集區自動配置的線程資源來取得。
注意
當您完成 Stream 時必須呼叫 Stream.Close ,以避免系統資源用盡。
在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 方法來取消尚未完成的CancelAsync異步操作。
BaseAddress如果屬性不是空字串 (“”) 且address
未指定絕對 URI,address
則必須是結合BaseAddress的相對 URI,才能形成所要求資源的絕對 URI。 QueryString如果 屬性不是 null
,則會附加至 address
。
此方法會使用 RETR 命令來下載 FTP 資源。 針對 HTTP 資源,會使用 GET 方法。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱 .NET Framework 中的網路追蹤。
另請參閱
適用於
OpenReadTaskAsync(Uri)
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
- 來源:
- WebClient.cs
使用工作物件,以非同步作業的方式開啟包含指定之資源的可讀取資料流。
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)
參數
- address
- Uri
要擷取之資源的 URI。
傳回
工作物件,表示非同步作業。 工作物件上的 Result 屬性會傳回用來從資源讀取資料的 Stream。
- 屬性
例外狀況
address
參數為 null
。
備註
這項作業不會封鎖。 傳回 Task<TResult> 的物件會在開啟數據資源的可讀取數據流之後完成。 這個方法不會在數據流開啟時封鎖呼叫線程。
這個方法會擷 Stream 取用來存取 參數所 address
指定資源的實例。 數據流是使用從線程集區自動配置的線程資源來取得。
注意
當您完成 Stream 時必須呼叫 Stream.Close ,以避免系統資源用盡。
在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 方法來取消尚未完成的CancelAsync異步操作。
BaseAddress如果屬性不是空字串 (“”) 且address
未指定絕對 URI,address
則必須是結合BaseAddress的相對 URI,才能形成所要求資源的絕對 URI。 QueryString如果 屬性不是 null
,則會附加至 address
。
此方法會使用 RETR 命令來下載 FTP 資源。 針對 HTTP 資源,會使用 GET 方法。
注意
在應用程式中啟用網路追蹤時,這個成員會輸出追蹤資訊。 如需詳細資訊,請參閱 .NET Framework 中的網路追蹤。
另請參閱
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應