WebClient.DownloadFileTaskAsync 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 pomocí objektu úkolu. Tyto metody neblokují volající vlákno.
Přetížení
DownloadFileTaskAsync(String, String) |
Stáhne zadaný prostředek do místního souboru jako asynchronní operaci pomocí objektu úkolu. |
DownloadFileTaskAsync(Uri, String) |
Stáhne zadaný prostředek do místního souboru jako asynchronní operaci pomocí objektu úkolu. |
DownloadFileTaskAsync(String, String)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Stáhne zadaný prostředek do místního souboru jako asynchronní operaci pomocí objektu úkolu.
public:
System::Threading::Tasks::Task ^ DownloadFileTaskAsync(System::String ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);
member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task
Public Function DownloadFileTaskAsync (address As String, fileName As String) As Task
Parametry
- address
- String
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.
Návraty
Objekt úlohy představující asynchronní operaci.
- Atributy
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 operace nebude blokována. Task Vrácený objekt se dokončí po stažení datového prostředku.
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.
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
DownloadFileTaskAsync(Uri, String)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
Stáhne zadaný prostředek do místního souboru jako asynchronní operaci pomocí objektu úkolu.
public:
System::Threading::Tasks::Task ^ DownloadFileTaskAsync(Uri ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);
member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task
Public Function DownloadFileTaskAsync (address As Uri, fileName As String) As Task
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.
Návraty
Objekt úlohy představující asynchronní operaci.
- Atributy
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 operace nebude blokována. Task Vrácený objekt se dokončí po stažení datového prostředku.
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.
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