WebClient.DownloadDataAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.WebClient.dll

Stáhne prostředek jako Byte pole z identifikátoru URI zadaného jako asynchronní operace. Tyto metody neblokují volající vlákno.

Přetížení

Name	Description
DownloadDataAsync(Uri)	Stáhne prostředek jako Byte pole z identifikátoru URI zadaného jako asynchronní operace.
DownloadDataAsync(Uri, Object)	Stáhne prostředek jako Byte pole z identifikátoru URI zadaného jako asynchronní operace.

DownloadDataAsync(Uri)

Zdroj:

WebClient.cs

Stáhne prostředek jako Byte pole z identifikátoru URI zadaného jako asynchronní operace.

public:
 void DownloadDataAsync(Uri ^ address);

public void DownloadDataAsync(Uri address);

member this.DownloadDataAsync : Uri -> unit

Public Sub DownloadDataAsync (address As Uri)

Parametry

address

Uri

A Uri obsahující identifikátor URI ke stažení.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Při stahování prostředku došlo k chybě.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Tato metoda načte zadaný prostředek pomocí výchozí metody pro protokol přidružený k schématu identifikátoru URI zadanému v address. Data se stáhnou asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

Tato metoda neblokuje volající vlákno při stahování prostředku. Pokud chcete stáhnout prostředek a blokovat při čekání na odpověď serveru, použijte jednu z DownloadData těchto metod. Po dokončení DownloadDataCompleted stahování se vyvolá událost. Aby vaše aplikace obdržela oznámení, musí tuto událost zpracovat. Stažená data jsou k dispozici ve Result vlastnosti.

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které nebyly dokončeny voláním CancelAsync metody.

Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který se zkombinuje s absolutním identifikátorem BaseAddress URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, je připojen k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané DownloadData(Uri).

DownloadDataAsync(Uri, Object)

Zdroj:

WebClient.cs

Stáhne prostředek jako Byte pole z identifikátoru URI zadaného jako asynchronní operace.

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

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

member this.DownloadDataAsync : Uri * obj -> unit

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

Parametry

address

Uri

A Uri obsahující identifikátor URI ke stažení.

userToken

Object

Uživatelem definovaný objekt, který se předá metodě vyvolá při dokončení asynchronní operace.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Při stahování prostředku došlo k chybě.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Tato metoda načte zadaný prostředek pomocí výchozí metody pro protokol přidružený k schématu identifikátoru URI zadanému v address. Data se stáhnou asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken.

Tato metoda neblokuje volající vlákno při stahování prostředku. Pokud chcete stáhnout prostředek a blokovat při čekání na odpověď serveru, použijte jednu z DownloadData těchto metod. Po dokončení DownloadDataCompleted stahování se vyvolá událost. Aby vaše aplikace obdržela oznámení, musí tuto událost zpracovat. Stažená data jsou k dispozici ve Result vlastnosti.

V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které nebyly dokončeny voláním CancelAsync metody.

Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který se zkombinuje s absolutním identifikátorem BaseAddress URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, je připojen k address.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.