WebClient.DownloadStringTaskAsync 方法

定義

命名空間:

System.Net

組件:

System.Net.WebClient.dll

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

多載

DownloadStringTaskAsync(String)	使用工作物件，從指定為異步操作的 URI 下載資源作為 String。
DownloadStringTaskAsync(Uri)	使用工作物件，從指定為異步操作的 URI 下載資源作為 String。

DownloadStringTaskAsync(String)

來源:

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);

member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>

Public Function DownloadStringTaskAsync (address As String) As Task(Of String)

參數

address

String

要下載之資源的 URI。

傳回

Task<String>

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

例外狀況

ArgumentNullException

address 參數是 null。

WebException

結合 BaseAddress 和 address 所形成的 URI 無效。

-或-

下載資源時發生錯誤。

備註

謹慎

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

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);

member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>

Public Function DownloadStringTaskAsync (address As Uri) As Task(Of String)

參數

address

Uri

要下載之資源的 URI。

傳回

Task<String>

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

例外狀況

ArgumentNullException

address 參數是 null。

WebException

結合 BaseAddress 和 address 所形成的 URI 無效。

-或-

下載資源時發生錯誤。

備註

謹慎

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