WebClient.DownloadFileTaskAsync Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

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

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);

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, který chcete stáhnout.

fileName

String

Název souboru, který se má umístit do místního počítače.

Návraty

Task

Objekt úkolu představující asynchronní operaci.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr fileName 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ě.

InvalidOperationException

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 operace nebude blokovat. Vrácený Task 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í 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.

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.

DownloadFileTaskAsync(Uri, String)

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);

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, který chcete stáhnout.

fileName

String

Název souboru, který se má umístit do místního počítače.

Návraty

Task

Objekt úkolu představující asynchronní operaci.

Výjimky

ArgumentNullException

Parametr address je null.

-nebo-

Parametr fileName 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ě.

InvalidOperationException

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 operace nebude blokovat. Vrácený Task 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í 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.

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.