WebClient.DownloadFile Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter.

Überlädt

DownloadFile(Uri, String)	Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter.
DownloadFile(String, String)	Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter.

DownloadFile(Uri, String)

Quelle:

WebClient.cs

Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter.

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)

Parameter

address

Uri

Der als Stringangegebene URI, aus dem Daten heruntergeladen werden sollen.

fileName

String

Der Name der lokalen Datei, die die Daten empfängt.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

-oder-

Der parameter fileName ist null.

WebException

Der URI, der durch die Kombination von BaseAddress und address gebildet wird, ist ungültig.

-oder-

filename ist null oder Empty.

-oder-

Die Datei ist nicht vorhanden.

-oder-

Fehler beim Herunterladen von Daten.

NotSupportedException

Die Methode wurde für mehrere Threads gleichzeitig aufgerufen.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die DownloadFile-Methode lädt in eine lokale Dateidaten aus dem im address Parameter angegebenen URI herunter. Diese Methode blockiert beim Herunterladen der Ressource. Wenn Sie eine Ressource herunterladen und die Ausführung fortsetzen möchten, während sie auf die Antwort des Servers warten, verwenden Sie eine der DownloadFileAsync Methoden.

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString keine leere Zeichenfolge ist, wird sie an addressangefügt.

Diese Methode verwendet den BEFEHL RETR, um eine FTP-Ressource herunterzuladen. Für eine HTTP-Ressource wird die GET-Methode verwendet.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Wenn Sie diese Methode in einer Anwendung auf mittlerer Ebene verwenden, z. B. eine ASP.NET-Seite, erhalten Sie eine Fehlermeldung, wenn das Konto, unter dem die Anwendung ausgeführt wird, nicht über die Berechtigung zum Zugriff auf die Datei verfügt.

DownloadFile(String, String)

Quelle:

WebClient.cs

Lädt die Ressource mit dem angegebenen URI in eine lokale Datei herunter.

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)

Parameter

address

String

Der URI, aus dem Daten heruntergeladen werden sollen.

fileName

String

Der Name der lokalen Datei, die die Daten empfängt.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

WebException

Der URI, der durch die Kombination von BaseAddress und address gebildet wird, ist ungültig.

-oder-

filename ist null oder Empty.

-oder-

Die Datei ist nicht vorhanden.

-oder- Fehler beim Herunterladen von Daten.

NotSupportedException

Die Methode wurde für mehrere Threads gleichzeitig aufgerufen.

Beispiele

Im folgenden Codebeispiel wird eine Datei von http://www.contoso.com auf die lokale Festplatte heruntergeladen.

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

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die DownloadFile-Methode lädt in eine lokale Dateidaten aus dem im address Parameter angegebenen URI herunter. Diese Methode blockiert beim Herunterladen der Ressource. Wenn Sie eine Ressource herunterladen und die Ausführung fortsetzen möchten, während sie auf die Antwort des Servers warten, verwenden Sie eine der DownloadFileAsync Methoden.

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString keine leere Zeichenfolge ist, wird sie an addressangefügt.

Diese Methode verwendet den BEFEHL RETR, um eine FTP-Ressource herunterzuladen. Für eine HTTP-Ressource wird die GET-Methode verwendet.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Wenn Sie diese Methode in einer Anwendung auf mittlerer Ebene verwenden, z. B. eine ASP.NET-Seite, erhalten Sie eine Fehlermeldung, wenn das Konto, unter dem die Anwendung ausgeführt wird, nicht über die Berechtigung zum Zugriff auf die Datei verfügt.