WebClient.DownloadFile Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

Stáhne prostředek se zadaným identifikátorem URI do místního souboru.

Přetížení

DownloadFile(Uri, String)	Stáhne prostředek se zadaným identifikátorem URI do místního souboru.
DownloadFile(String, String)	Stáhne prostředek se zadaným identifikátorem URI do místního souboru.

DownloadFile(Uri, String)

Zdroj:

WebClient.cs

Stáhne prostředek se zadaným identifikátorem URI do místního souboru.

public:
 void DownloadFile(Uri ^ address, System::String ^ fileName);

public void DownloadFile (Uri address, string fileName);

member this.DownloadFile : Uri * string -> unit

Public Sub DownloadFile (address As Uri, fileName As String)

Parametry

address

Uri

Identifikátor URI zadaný jako String, ze kterého se mají stahovat data.

fileName

String

Název místního souboru, který má přijímat data.

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-

filename je null nebo Empty.

-nebo-

Soubor neexistuje.

-nebo-

Při stahování dat došlo k chybě.

NotSupportedException

Metoda byla volána současně ve více vláknech.

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.

Metoda DownloadFile stáhne data místního souboru z identifikátoru URI určeného v parametru address. Tato metoda blokuje při stahování prostředku. Pokud chcete stáhnout prostředek a pokračovat v provádění při čekání na odpověď serveru, použijte jednu z DownloadFileAsync metod.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru 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 v aplikaci střední vrstvy, například na stránce ASP.NET, se zobrazí chyba, pokud účet, pod kterým se aplikace spouští, nemá oprávnění pro přístup k souboru.

DownloadFile(String, String)

Zdroj:

WebClient.cs

Stáhne prostředek se zadaným identifikátorem URI do místního souboru.

public:
 void DownloadFile(System::String ^ address, System::String ^ fileName);

public void DownloadFile (string address, string fileName);

member this.DownloadFile : string * string -> unit

Public Sub DownloadFile (address As String, fileName As String)

Parametry

address

String

Identifikátor URI, ze kterého se mají stahovat data.

fileName

String

Název místního souboru, který má přijímat data.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

filename je null nebo Empty.

-nebo-

Soubor neexistuje.

-nebo- Při stahování dat došlo k chybě.

NotSupportedException

Metoda byla volána současně ve více vláknech.

Příklady

Následující příklad kódu stáhne soubor z http://www.contoso.com na místní pevný disk.

String^ remoteUri = "http://www.contoso.com/library/homepage/images/";
String^ fileName = "ms-banner.gif", ^myStringWebResource = nullptr;
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Concatenate the domain with the Web resource filename.
myStringWebResource = String::Concat( remoteUri, fileName );
Console::WriteLine( "Downloading File \"{0}\" from \"{1}\" .......\n\n", fileName, myStringWebResource );
// Download the Web resource and save it into the current filesystem folder.
myWebClient->DownloadFile( myStringWebResource, fileName );
Console::WriteLine( "Successfully Downloaded File \"{0}\" from \"{1}\"", fileName, myStringWebResource );
Console::WriteLine( "\nDownloaded file saved in the following file system folder:\n\t {0}", Application::StartupPath );

string remoteUri = "http://www.contoso.com/library/homepage/images/";
string fileName = "ms-banner.gif", myStringWebResource = null;
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Concatenate the domain with the Web resource filename.
myStringWebResource = remoteUri + fileName;
Console.WriteLine("Downloading File \"{0}\" from \"{1}\" .......\n\n", fileName, myStringWebResource);
// Download the Web resource and save it into the current filesystem folder.
myWebClient.DownloadFile(myStringWebResource,fileName);		
Console.WriteLine("Successfully Downloaded File \"{0}\" from \"{1}\"", fileName, myStringWebResource);
Console.WriteLine("\nDownloaded file saved in the following file system folder:\n\t" + Application.StartupPath);

Dim remoteUri As String = "http://www.contoso.com/library/homepage/images/"
Dim fileName As String = "ms-banner.gif"
Dim myStringWebResource As String = Nothing
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Concatenate the domain with the Web resource filename. Because DownloadFile 
'requires a fully qualified resource name, concatenate the domain with the Web resource file name.
myStringWebResource = remoteUri + fileName
Console.WriteLine("Downloading File ""{0}"" from ""{1}"" ......." + ControlChars.Cr + ControlChars.Cr, fileName, myStringWebResource)
' The DownloadFile() method downloads the Web resource and saves it into the current file-system folder.
myWebClient.DownloadFile(myStringWebResource, fileName)
Console.WriteLine("Successfully Downloaded file ""{0}"" from ""{1}""", fileName, myStringWebResource)
Console.WriteLine((ControlChars.Cr + "Downloaded file saved in the following file system folder:" + ControlChars.Cr + ControlChars.Tab + Application.StartupPath))

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.

Metoda DownloadFile stáhne data místního souboru z identifikátoru URI určeného v parametru address. Tato metoda blokuje při stahování prostředku. Pokud chcete stáhnout prostředek a pokračovat v provádění při čekání na odpověď serveru, použijte jednu z DownloadFileAsync metod.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru 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 v aplikaci střední vrstvy, například na stránce ASP.NET, se zobrazí chyba, pokud účet, pod kterým se aplikace spouští, nemá oprávnění pro přístup k souboru.