WebClient.DownloadFile 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 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
- Zdroj:
- WebClient.cs
- 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
- fileName
- String
Název místního souboru, který má přijímat data.
Výjimky
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ě.
Metoda byla volána současně ve více vláknech.
Poznámky
Metoda DownloadFile stáhne data z identifikátoru URI určeného parametrem address
do místního souboru. 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 těchto metod.
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje 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 používá příkaz RETR ke stažení prostředku FTP. 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 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.
Platí pro
DownloadFile(String, String)
- Zdroj:
- WebClient.cs
- Zdroj:
- WebClient.cs
- 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
Parametr address
je null
.
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ě.
Metoda byla volána současně ve více vláknech.
Příklady
Následující příklad kódu stáhne soubor z na http://www.contoso.com 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
Metoda DownloadFile stáhne data z identifikátoru URI určeného parametrem address
do místního souboru. 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 těchto metod.
BaseAddress Pokud vlastnost není prázdný řetězec ("") a address
neobsahuje 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 používá příkaz RETR ke stažení prostředku FTP. 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 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.
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