WebClient.DownloadDataAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
- Zdroj:
- WebClient.cs
- 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
Výjimky
Parametr address
je null
.
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átorů URI zadanému v address
. Data se stahují asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny 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 ho při čekání na odpověď serveru, použijte některou DownloadData z těchto metod. Po dokončení DownloadDataCompleted stahování se událost vyvolá. 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é se nedokončily, 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, 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 nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem DownloadData(Uri).
Platí pro
DownloadDataAsync(Uri, Object)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- 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);
public void DownloadDataAsync (Uri address, object userToken);
member this.DownloadDataAsync : Uri * obj -> unit
Public Sub DownloadDataAsync (address As Uri, userToken As Object)
Parametry
- userToken
- Object
Uživatelem definovaný objekt, který je předán metodě vyvolány při dokončení asynchronní operace.
Výjimky
Parametr address
je null
.
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átorů URI zadanému v address
. Data se stahují asynchronně pomocí prostředků vlákna, které jsou automaticky přiděleny 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 ho při čekání na odpověď serveru, použijte některou DownloadData z těchto metod. Po dokončení DownloadDataCompleted stahování se událost vyvolá. 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é se nedokončily, 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, 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.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro