WebClient.DownloadStringTaskAsync Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Letölti az erőforrást String az aszinkron műveletként megadott URI-ból egy tevékenységobjektum használatával. Ezek a metódusok nem tiltják le a hívó szálat.

Túlterhelések

Name	Description
DownloadStringTaskAsync(String)	Letölti az erőforrást String az aszinkron műveletként megadott URI-ból egy tevékenységobjektum használatával.
DownloadStringTaskAsync(Uri)	Letölti az erőforrást String az aszinkron műveletként megadott URI-ból egy tevékenységobjektum használatával.

DownloadStringTaskAsync(String)

Forrás:

WebClient.cs

Letölti az erőforrást String az aszinkron műveletként megadott URI-ból egy tevékenységobjektum használatával.

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)

Paraméterek

address

String

A letölteni kívánt erőforrás URI-ja.

Válaszok

Task<String>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result tevékenységobjektum tulajdonsága egy letöltött erőforrást Byte tartalmazó tömböt ad vissza.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Hiba történt az erőforrás letöltése közben.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum az adaterőforrás letöltése után befejeződik. Az erőforrás aszinkron módon töltődik le a szálkészletből automatikusan lefoglalt szálerőforrások használatával.

Az erőforrás letöltése után ez a metódus a tulajdonságban Encoding megadott kódolással konvertálja az erőforrást egy String. Ez a metódus nem blokkolja a hívó szálat az erőforrás letöltése közben.

A .NET-keretrendszerben a CancelAsync metódus meghívásával megszakíthatja a nem befejezett aszinkron műveleteket.

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Ez a metódus a RETR paranccsal tölt le egy FTP-erőforrást. HTTP-erőforrás esetén a GET metódust használja a rendszer.

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

DownloadStringTaskAsync(Uri)

Forrás:

WebClient.cs

Letölti az erőforrást String az aszinkron műveletként megadott URI-ból egy tevékenységobjektum használatával.

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)

Paraméterek

address

Uri

A letölteni kívánt erőforrás URI-ja.

Válaszok

Task<String>

Az aszinkron műveletet képviselő tevékenységobjektum. A Result tevékenységobjektum tulajdonsága egy letöltött erőforrást Byte tartalmazó tömböt ad vissza.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Hiba történt az erőforrás letöltése közben.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a művelet nem blokkolja a műveletet. A visszaadott Task<TResult> objektum az adaterőforrás letöltése után befejeződik. Az erőforrás aszinkron módon töltődik le a szálkészletből automatikusan lefoglalt szálerőforrások használatával.

Az erőforrás letöltése után ez a metódus a tulajdonságban Encoding megadott kódolással konvertálja az erőforrást egy String. Ez a metódus nem blokkolja a hívó szálat az erőforrás letöltése közben.

A .NET-keretrendszerben a CancelAsync metódus meghívásával megszakíthatja a nem befejezett aszinkron műveleteket.

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Ez a metódus a RETR paranccsal tölt le egy FTP-erőforrást. HTTP-erőforrás esetén a GET metódust használja a rendszer.

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.