WebClient.OpenReadTaskAsync 方法

定義

使用工作物件,以非同步作業的方式開啟包含指定之資源的可讀取資料流。 這些方法不會封鎖呼叫執行緒。

多載

OpenReadTaskAsync(String)

使用工作物件,以非同步作業的方式開啟包含指定之資源的可讀取資料流。

OpenReadTaskAsync(Uri)

使用工作物件,以非同步作業的方式開啟包含指定之資源的可讀取資料流。

OpenReadTaskAsync(String)

使用工作物件,以非同步作業的方式開啟包含指定之資源的可讀取資料流。

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

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

-或-

下載資源時發生錯誤。

-或-

開啟資料流時發生錯誤。

備註

這項作業不會封鎖。 傳回 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)

使用工作物件,以非同步作業的方式開啟包含指定之資源的可讀取資料流。

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

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

-或-

下載資源時發生錯誤。

-或-

開啟資料流時發生錯誤。

備註

這項作業不會封鎖。 傳回 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 中的網路追蹤

另請參閱

適用於