WebClient.OpenReadTaskAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

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

多載

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、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。 請改用 HttpClient。

此作業不會封鎖。 傳回 Task<TResult> 物件會在開啟數據資源的可讀取數據流之後完成。 這個方法不會在數據流開啟時封鎖呼叫線程。

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

注意

當您完成 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 中的網路追蹤。

另請參閱

• 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、ServicePoint和 WebClient 已經過時，您不應該將它們用於新的開發。 請改用 HttpClient。

此作業不會封鎖。 傳回 Task<TResult> 物件會在開啟數據資源的可讀取數據流之後完成。 這個方法不會在數據流開啟時封鎖呼叫線程。

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

注意

當您完成 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 中的網路追蹤。

另請參閱

• Stream