WebClient.OpenReadAsync 方法

定義

命名空間:

System.Net

組件:

netstandard.dll, System.Net.WebClient.dll

開啟包含指定資源的可讀取數據流。 這些方法不會封鎖呼叫線程。

多載

名稱	Description
OpenReadAsync(Uri)	開啟包含指定資源的可讀取數據流。 這個方法不會封鎖呼叫線程。
OpenReadAsync(Uri, Object)	開啟包含指定資源的可讀取數據流。 這個方法不會封鎖呼叫線程。

OpenReadAsync(Uri)

來源:

WebClient.cs

開啟包含指定資源的可讀取數據流。 這個方法不會封鎖呼叫線程。

public:
 void OpenReadAsync(Uri ^ address);

public void OpenReadAsync(Uri address);

member this.OpenReadAsync : Uri -> unit

Public Sub OpenReadAsync (address As Uri)

參數

address

Uri

要擷取之資源的 URI。

例外狀況

ArgumentNullException

參數 address 為 null。

WebException

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

-或-

下載資源時發生錯誤。

-或-

開啟數據流時發生錯誤。

備註

注意事項

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

此方法會 Stream 擷取用於存取參數指定 address 資源的實例。 數據流是使用從線程集區自動配置的線程資源來取得。 若要接收串流可用通知，請在事件中新增事件處理 OpenReadCompleted 程式。

Note

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

這個方法不會在數據流開啟時封鎖呼叫線程。 要在等待直播時封鎖，請使用這個 OpenReadAsync 方法。

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

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

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

Note

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

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 OpenRead(Uri)拋出的例外。

OpenReadAsync(Uri, Object)

來源:

WebClient.cs

開啟包含指定資源的可讀取數據流。 這個方法不會封鎖呼叫線程。

public:
 void OpenReadAsync(Uri ^ address, System::Object ^ userToken);

public void OpenReadAsync(Uri address, object? userToken);

member this.OpenReadAsync : Uri * obj -> unit

Public Sub OpenReadAsync (address As Uri, userToken As Object)

參數

address

Uri

要擷取之資源的 URI。

userToken

Object

使用者定義對象，傳遞至異步操作完成時叫用的方法。

例外狀況

ArgumentNullException

參數 address 為 null。

WebException

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

-或-

下載資源時發生錯誤。

-或-

開啟數據流時發生錯誤。

備註

注意事項

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

此方法會 Stream 擷取用於存取參數指定 address 資源的實例。 數據流是使用從線程集區自動配置的線程資源來取得。 若要接收串流可用通知，請在事件中新增事件處理 OpenReadCompleted 程式。

Note

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

這個方法不會在數據流開啟時封鎖呼叫線程。 要在等待直播時封鎖，請使用這個 OpenRead 方法。

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

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

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

Note

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