WebClient.DownloadFile Methode

Definitie

Naamruimte:
System.Net
Assembly:
System.dll
Assembly:
netstandard.dll

Hiermee downloadt u de resource met de opgegeven URI naar een lokaal bestand.

Overloads

Name Description
DownloadFile(Uri, String)

Hiermee downloadt u de resource met de opgegeven URI naar een lokaal bestand.
DownloadFile(String, String)

Hiermee downloadt u de resource met de opgegeven URI naar een lokaal bestand.

DownloadFile(Uri, String)

Hiermee downloadt u de resource met de opgegeven URI naar een lokaal bestand.

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)

Parameters

address
Uri

De URI die is opgegeven als een String, van waaruit gegevens moeten worden gedownload.

fileName
String

De naam van het lokale bestand dat de gegevens moet ontvangen.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De fileName parameter is null.

WebException

De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.

– of –

fileName is null of Empty.

– of –

Het bestand bestaat niet.

– of –

Er is een fout opgetreden tijdens het downloaden van gegevens.

NotSupportedException

De methode is gelijktijdig aangeroepen op meerdere threads.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

De DownloadFile methode wordt gedownload naar een lokaal bestand van de URI die is opgegeven in de address parameter. Deze methode blokkeert tijdens het downloaden van de resource. Als u een resource wilt downloaden en wilt blijven uitvoeren terwijl u wacht op het antwoord van de server, gebruikt u een van de DownloadFileAsync methoden.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Deze methode gebruikt de RETR-opdracht om een FTP-resource te downloaden. Voor een HTTP-resource wordt de GET-methode gebruikt.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Wanneer u deze methode gebruikt in een middelste laag,zoals een ASP.NET pagina, krijgt u een foutmelding als het account waaronder de toepassing wordt uitgevoerd, geen toegang heeft tot het bestand.

Van toepassing op

DownloadFile(String, String)

Hiermee downloadt u de resource met de opgegeven URI naar een lokaal bestand.

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)

Parameters

address
String

De URI van waaruit gegevens moeten worden gedownload.

fileName
String

De naam van het lokale bestand dat de gegevens moet ontvangen.

Uitzonderingen

ArgumentNullException

De address parameter is null.

WebException

De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.

– of –

fileName is null of Empty.

– of –

Het bestand bestaat niet.

-of- Er is een fout opgetreden tijdens het downloaden van gegevens.

NotSupportedException

De methode is gelijktijdig aangeroepen op meerdere threads.

Voorbeelden

In het volgende codevoorbeeld wordt een bestand gedownload van http://www.contoso.com de lokale harde schijf.

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

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

De DownloadFile methode wordt gedownload naar een lokaal bestand van de URI die is opgegeven in de address parameter. Deze methode blokkeert tijdens het downloaden van de resource. Als u een resource wilt downloaden en wilt blijven uitvoeren terwijl u wacht op het antwoord van de server, gebruikt u een van de DownloadFileAsync methoden.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Deze methode gebruikt de RETR-opdracht om een FTP-resource te downloaden. Voor een HTTP-resource wordt de GET-methode gebruikt.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Wanneer u deze methode gebruikt in een middelste laag,zoals een ASP.NET pagina, krijgt u een foutmelding als het account waaronder de toepassing wordt uitgevoerd, geen toegang heeft tot het bestand.

Van toepassing op