WebClient.OpenReadTaskAsync 方法

定義

命名空間:

System.Net

組件:

netstandard.dll, System.Net.WebClient.dll

使用工作物件開啟包含指定資源的可讀取數據流，做為異步操作。 這些方法不會封鎖呼叫線程。

多載

名稱	Description
OpenReadTaskAsync(String)	使用工作物件開啟包含指定資源的可讀取數據流，做為異步操作。
OpenReadTaskAsync(Uri)	使用工作物件開啟包含指定資源的可讀取數據流，做為異步操作。

OpenReadTaskAsync(String)

來源:

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);

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

Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)

參數

address

String

要擷取之資源的 URI。

傳回

Task<Stream>

表示異步操作的工作物件。 任務物件上的 Result 屬性會回傳 用 Stream 來從資源讀取資料。

例外狀況

ArgumentNullException

參數 address 為 null。

WebException

由 和 位址組合 BaseAddress 形成的 URI 是無效的。

-或-

下載資源時發生錯誤。

-或-

開啟數據流時發生錯誤。

備註

注意事項

WebRequest、、HttpWebRequest、ServicePointWebClient、和 都已過時，你不應該用它們來做新開發。 請改用 HttpClient。

這個行動不會被阻擋。 回傳 Task<TResult> 的物件會在開啟可讀取的資料串流後完成。 這個方法不會在數據流開啟時封鎖呼叫線程。

此方法會 Stream 擷取用於存取參數指定 address 資源的實例。 數據流是使用從線程集區自動配置的線程資源來取得。

Note

完成時必須打電話Stream.CloseStream，以避免系統資源耗盡。

在 .NET Framework 中，你可以透過呼叫 CancelAsync 方法來取消尚未完成的非同步操作。

若屬性 BaseAddress 不是空字串（“”）且 address 未指定絕對 URI，則 address 必須是相對 URI，與 結合 BaseAddress 形成請求資源的絕對 URI。 若性質 QueryString 不 null為 ，則附加於 address。

此方法會使用 RETR 命令來下載 FTP 資源。 針對 HTTP 資源，會使用 GET 方法。

Note

當您在應用程式中啟用網路追蹤時，此成員會輸出追蹤資訊。 欲了解更多資訊，請參閱.NET框架中的網路追蹤。

另請參閱

• Stream

OpenReadTaskAsync(Uri)

來源:

WebClient.cs

使用工作物件開啟包含指定資源的可讀取數據流，做為異步操作。

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

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

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

Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)

參數

address

Uri

要擷取之資源的 URI。

傳回

Task<Stream>

表示異步操作的工作物件。 任務物件上的 Result 屬性會回傳 用 Stream 來從資源讀取資料。

例外狀況

ArgumentNullException

參數 address 為 null。

WebException

由 和 位址組合 BaseAddress 形成的 URI 是無效的。

-或-

下載資源時發生錯誤。

-或-

開啟數據流時發生錯誤。

備註

注意事項

WebRequest、、HttpWebRequest、ServicePointWebClient、和 都已過時，你不應該用它們來做新開發。 請改用 HttpClient。

這個行動不會被阻擋。 回傳 Task<TResult> 的物件會在開啟可讀取的資料串流後完成。 這個方法不會在數據流開啟時封鎖呼叫線程。

此方法會 Stream 擷取用於存取參數指定 address 資源的實例。 數據流是使用從線程集區自動配置的線程資源來取得。

Note

完成時必須打電話Stream.CloseStream，以避免系統資源耗盡。

在 .NET Framework 中，你可以透過呼叫 CancelAsync 方法來取消尚未完成的非同步操作。

若屬性 BaseAddress 不是空字串（“”）且 address 未指定絕對 URI，則 address 必須是相對 URI，與 結合 BaseAddress 形成請求資源的絕對 URI。 若性質 QueryString 不 null為 ，則附加於 address。

此方法會使用 RETR 命令來下載 FTP 資源。 針對 HTTP 資源，會使用 GET 方法。

Note

當您在應用程式中啟用網路追蹤時，此成員會輸出追蹤資訊。 欲了解更多資訊，請參閱.NET框架中的網路追蹤。

另請參閱

• Stream