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 do místního souboru prostředek se zadaným identifikátorem URI. Tato metoda neblokuje volající vlákno. |
DownloadFileAsync(Uri, String, Object) |
Stáhne do místního souboru prostředek 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 do místního souboru prostředek 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 -> unit
Public Sub DownloadFileAsync (address As Uri, fileName As String)
Parametry
- address
- Uri
Identifikátor URI prostředku ke stažení
- 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ý nástrojem fileName
je používán jiným vláknem.
Poznámky
Tato metoda stáhne prostředek na identifikátor URI zadaný v parametru address
. Po úspěšném dokončení stahování bude stažený soubor v místním počítači pojmenován fileName
. 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í, že je soubor k dispozici, přidejte do události obslužnou rutinu DownloadFileCompleted události.
Tato metoda neblokuje volající vlákno během stahování prostředku. Pokud chcete blokovat dobu čekání na dokončení stahování, použijte jednu z těchto DownloadFile metod.
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 .
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neurčuje 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
.
Tato metoda ke stažení prostředku FTP používá příkaz RETR. Pro prostředek HTTP se používá metoda GET.
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.
Při použití této metody na ASP.NET stránce 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, 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 DownloadFile(Uri, String).
Platí pro
DownloadFileAsync(Uri, String, Object)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Stáhne do místního souboru prostředek 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 -> unit
Public Sub DownloadFileAsync (address As Uri, fileName As String, userToken As Object)
Parametry
- address
- Uri
Identifikátor URI prostředku ke stažení
- fileName
- String
Název souboru, který se má umístit do místního počítače.
- userToken
- Object
Uživatelem definovaný objekt, který je předán metodě vyvolány po 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ý nástrojem fileName
je používán jiným vláknem.
Poznámky
Tato metoda stáhne prostředek na identifikátor URI zadaný v parametru address
. Po úspěšném dokončení stahování bude stažený soubor v místním počítači pojmenován fileName
. 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í, že je soubor k dispozici, přidejte do události obslužnou rutinu DownloadFileCompleted události.
Tato metoda neblokuje volající vlákno během stahování prostředku. Pokud chcete blokovat dobu čekání na dokončení stahování, použijte jednu z těchto DownloadFile metod.
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 .
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neurčuje 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
.
Tato metoda ke stažení prostředku FTP používá příkaz RETR. Pro prostředek HTTP se používá metoda GET.
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.
Při použití této metody na ASP.NET stránce 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.
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