共用方式為


WebClient.DownloadStringTaskAsync 方法

定義

使用工作物件,從指定為異步操作的 URI 下載資源作為 String。 這些方法不會封鎖呼叫線程。

多載

DownloadStringTaskAsync(String)

使用工作物件,從指定為異步操作的 URI 下載資源作為 String

DownloadStringTaskAsync(Uri)

使用工作物件,從指定為異步操作的 URI 下載資源作為 String

DownloadStringTaskAsync(String)

來源:
WebClient.cs
來源:
WebClient.cs
來源:
WebClient.cs

使用工作物件,從指定為異步操作的 URI 下載資源作為 String

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(System::String ^ address);
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);
member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>
Public Function DownloadStringTaskAsync (address As String) As Task(Of String)

參數

address
String

要下載之資源的 URI。

傳回

表示異步操作的工作物件。 工作物件上的 Result 屬性會傳回包含已下載資源的 Byte 陣列。

屬性

例外狀況

address 參數是 null

結合 BaseAddressaddress 所形成的 URI 無效。

-或-

下載資源時發生錯誤。

備註

謹慎

WebRequestHttpWebRequestServicePointWebClient 已經過時,您不應該將它們用於新的開發。 請改用 HttpClient

此作業不會封鎖。 傳回 Task<TResult> 物件會在下載數據資源之後完成。 資源會使用從線程集區自動配置的線程資源,以異步方式下載資源。

下載資源之後,這個方法會使用 Encoding 屬性中指定的編碼方式,將資源轉換成 String。 此方法不會在下載資源時封鎖呼叫線程。

在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 CancelAsync 方法來取消尚未完成的異步操作。

如果 BaseAddress 屬性不是空字串 (“”) 且 address 不包含絕對 URI,address 必須是與 BaseAddress 結合的相對 URI,才能形成所要求數據的絕對 URI。 如果 QueryString 屬性不是空字串,則會附加至 address

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

當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 如需詳細資訊,請參閱 .NET Framework 中的網路追蹤

適用於

DownloadStringTaskAsync(Uri)

來源:
WebClient.cs
來源:
WebClient.cs
來源:
WebClient.cs

使用工作物件,從指定為異步操作的 URI 下載資源作為 String

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);
member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>
Public Function DownloadStringTaskAsync (address As Uri) As Task(Of String)

參數

address
Uri

要下載之資源的 URI。

傳回

表示異步操作的工作物件。 工作物件上的 Result 屬性會傳回包含已下載資源的 Byte 陣列。

屬性

例外狀況

address 參數是 null

結合 BaseAddressaddress 所形成的 URI 無效。

-或-

下載資源時發生錯誤。

備註

謹慎

WebRequestHttpWebRequestServicePointWebClient 已經過時,您不應該將它們用於新的開發。 請改用 HttpClient

此作業不會封鎖。 傳回 Task<TResult> 物件會在下載數據資源之後完成。 資源會使用從線程集區自動配置的線程資源,以異步方式下載資源。

下載資源之後,這個方法會使用 Encoding 屬性中指定的編碼方式,將資源轉換成 String。 此方法不會在下載資源時封鎖呼叫線程。

在 .NET Framework 和 .NET Core 1.0 中,您可以呼叫 CancelAsync 方法來取消尚未完成的異步操作。

如果 BaseAddress 屬性不是空字串 (“”) 且 address 不包含絕對 URI,address 必須是與 BaseAddress 結合的相對 URI,才能形成所要求數據的絕對 URI。 如果 QueryString 屬性不是空字串,則會附加至 address

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

當您在應用程式中啟用網路追蹤時,此成員會輸出追蹤資訊。 如需詳細資訊,請參閱 .NET Framework 中的網路追蹤

適用於