WebClient.DownloadFileAsync 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 zadaný prostředek do místního souboru jako asynchronní operaci. Tyto metody neblokují volající vlákno.
Přetížení
| DownloadFileAsync(Uri, String) |
Stáhne prostředek do místního souboru se zadaným identifikátorem URI. Tato metoda neblokuje volající vlákno. |
| DownloadFileAsync(Uri, String, Object) |
Stáhne prostředek do místního souboru se zadaným identifikátorem URI. Tato metoda neblokuje volající vlákno. |
DownloadFileAsync(Uri, String)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Stáhne prostředek do místního souboru se zadaným identifikátorem URI. Tato metoda neblokuje volající vlákno.
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName);public void DownloadFileAsync (Uri address, string fileName);member this.DownloadFileAsync : Uri * string -> unitPublic Sub DownloadFileAsync (address As Uri, fileName As String)Parametry
- address
- Uri
Identifikátor URI prostředku, který chcete stáhnout.
- fileName
- String
Název souboru, který se má umístit do místního počítače.
Výjimky
Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.
-nebo-
Při stahování prostředku došlo k chybě.
Místní soubor určený fileName je používán jiným vláknem.
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 stáhne prostředek na identifikátor URI zadaný v parametru address. Po úspěšném dokončení stahování se stažený soubor jmenuje fileName na místním počítači. Soubor se stáhne asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení, když je soubor k dispozici, přidejte obslužnou rutinu události do DownloadFileCompleted události.
Tato metoda neblokuje volající vlákno při stahování prostředku. Pokud chcete zablokovat čekání na dokončení stahování, použijte jednu z DownloadFile metod.
V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které nebyly dokončeny voláním metody CancelAsync.
Pokud BaseAddress vlastnost není prázdný řetězec ("") a address nezadá absolutní identifikátor URI, address musí být relativní identifikátor URI, který je kombinován s BaseAddress, aby se vytvořil absolutní identifikátor URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.
Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.
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.
Při použití této metody na stránce ASP.NET se zobrazí chyba, pokud účet, pod kterým se stránka spouští, nemá oprávnění pro přístup k místnímu souboru.
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ě. U uložených výjimek se podívejte na výjimky vyvolané DownloadFile(Uri, String).
Platí pro
DownloadFileAsync(Uri, String, Object)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Stáhne prostředek do místního souboru se zadaným identifikátorem URI. Tato metoda neblokuje volající vlákno.
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName, System::Object ^ userToken);public void DownloadFileAsync (Uri address, string fileName, object? userToken);public void DownloadFileAsync (Uri address, string fileName, object userToken);member this.DownloadFileAsync : Uri * string * obj -> unitPublic Sub DownloadFileAsync (address As Uri, fileName As String, userToken As Object)Parametry
- address
- Uri
Identifikátor URI prostředku, který chcete stáhnout.
- fileName
- String
Název souboru, který se má umístit do místního počítače.
- userToken
- Object
Uživatelem definovaný objekt, který se předá metodě vyvolá při dokončení asynchronní operace.
Výjimky
Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.
-nebo-
Při stahování prostředku došlo k chybě.
Místní soubor určený fileName je používán jiným vláknem.
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 stáhne prostředek na identifikátor URI zadaný v parametru address. Po úspěšném dokončení stahování se stažený soubor jmenuje fileName na místním počítači. Soubor se stáhne asynchronně pomocí prostředků vlákna, které se automaticky přidělují z fondu vláken. Pokud chcete dostávat oznámení, když je soubor k dispozici, přidejte obslužnou rutinu události do DownloadFileCompleted události.
Tato metoda neblokuje volající vlákno při stahování prostředku. Pokud chcete zablokovat čekání na dokončení stahování, použijte jednu z DownloadFile metod.
V rozhraní .NET Framework a .NET Core 1.0 můžete zrušit asynchronní operace, které nebyly dokončeny voláním metody CancelAsync.
Pokud BaseAddress vlastnost není prázdný řetězec ("") a address nezadá absolutní identifikátor URI, address musí být relativní identifikátor URI, který je kombinován s BaseAddress, aby se vytvořil absolutní identifikátor URI požadovaných dat. Pokud QueryString vlastnost není prázdný řetězec, připojí se k address.
Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.
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.
Při použití této metody na stránce ASP.NET se zobrazí chyba, pokud účet, pod kterým se stránka spouští, nemá oprávnění pro přístup k místnímu souboru.
