WebClient.DownloadStringTaskAsync 方法

  • 參考

定義

命名空間:
System.Net
組件:
System.Net.WebClient.dll
組件:
System.dll
組件:
netstandard.dll

使用工作物件，以非同步作業的方式，從指定的 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。

傳回

Task<String>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回包含已下載之資源的 Byte 陣列。

屬性
ComVisibleAttribute

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

下載資源時發生錯誤。

備註

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

傳回

Task<String>

工作物件，表示非同步作業。 工作物件上的 Result 屬性會傳回包含已下載之資源的 Byte 陣列。

屬性
ComVisibleAttribute

例外狀況

ArgumentNullException

address 參數為 null。

WebException

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

-或-

下載資源時發生錯誤。

備註

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

適用於