WebClient.DownloadDataAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

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í

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

Tato metoda načte zadaný prostředek pomocí výchozí metody pro protokol přidružený ke schématu identifikátoru URI zadanému v address. Data se stahují asynchronně pomocí prostředků vláken, 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 zablokovat ho při čekání na odpověď serveru, použijte jednu z těchto DownloadData 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ích .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které se nedokončily, voláním CancelAsync metody .

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

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem 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ý je předán metodě vyvolány po 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

Tato metoda načte zadaný prostředek pomocí výchozí metody pro protokol přidružený ke schématu identifikátoru URI zadanému v address. Data se stahují asynchronně pomocí prostředků vláken, 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 zablokovat ho při čekání na odpověď serveru, použijte jednu z těchto DownloadData 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ích .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které se nedokončily, voláním CancelAsync metody .

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

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, připojí se k address.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.