WebClient.DownloadStringAsync Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.WebClient.dll

Letölti az erőforrást String , amely egy vagy több erőforrásként van megadva Uri. Ezek a metódusok nem tiltják le a hívó szálat.

Túlterhelések

Name	Description
DownloadStringAsync(Uri)	Letölti a megadott erőforrást Uri. Ez a metódus nem blokkolja a hívó szálat.
DownloadStringAsync(Uri, Object)	Letölti a megadott sztringet a megadott erőforrásba. Ez a metódus nem blokkolja a hívó szálat.

DownloadStringAsync(Uri)

Forrás:

WebClient.cs

Letölti a megadott erőforrást Uri. Ez a metódus nem blokkolja a hívó szálat.

public:
 void DownloadStringAsync(Uri ^ address);

public void DownloadStringAsync(Uri address);

member this.DownloadStringAsync : Uri -> unit

Public Sub DownloadStringAsync (address As Uri)

Paraméterek

address

Uri

A Uri letöltendő URI-t tartalmazó fájl.

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.

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. Ha le szeretne tölteni egy erőforrást, és blokkolni szeretné a kiszolgáló válaszát, használja a metódust DownloadString . Amikor a letöltés befejeződik, az DownloadStringCompleted esemény megjelenik. Az alkalmazásnak kezelnie kell ezt az eseményt az értesítés fogadásához. A letöltött sztring elérhető a Result tulajdonságban.

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.

Note

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.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által DownloadString(Uri)kiadott kivételeket: .

DownloadStringAsync(Uri, Object)

Forrás:

WebClient.cs

Letölti a megadott sztringet a megadott erőforrásba. Ez a metódus nem blokkolja a hívó szálat.

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

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

member this.DownloadStringAsync : Uri * obj -> unit

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

Paraméterek

address

Uri

A Uri letöltendő URI-t tartalmazó fájl.

userToken

Object

Egy felhasználó által definiált objektum, amelyet a rendszer az aszinkron művelet befejezésekor meghívt metódusnak ad át.

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.

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. Ha le szeretne tölteni egy erőforrást, és blokkolni szeretné a kiszolgáló válaszát, használja a metódust DownloadString . Amikor a letöltés befejeződik, az DownloadStringCompleted esemény megjelenik. Az alkalmazásnak kezelnie kell ezt az eseményt az értesítés fogadásához. A letöltött sztring elérhető a Result tulajdonságban.

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.

Note

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.