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 ein String angegebene URI, von dem Daten heruntergeladen werden.

fileName

String

Der Name der lokalen Datei, die die Daten empfangen soll.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

- oder -

Der fileName-Parameter ist null.

WebException

Der durch Kombinieren von BaseAddress und address gebildete URI 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 gleichzeitig für mehrere Threads aufgerufen.

Hinweise

Die DownloadFile -Methode lädt Daten aus dem durch im Parameter angegebenen URI in address eine lokale Datei herunter. Diese Methode blockiert beim Herunterladen der Ressource. Verwenden Sie eine der DownloadFileAsync Methoden, um eine Ressource herunterzuladen und die Ausführung fortzusetzen, während sie auf die Antwort des Servers warten.

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

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

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Wenn Sie diese Methode in einer Anwendung der mittleren Ebene verwenden, z. B. auf einer ASP.NET Seite, erhalten Sie eine Fehlermeldung, wenn das Konto, unter dem die Anwendung ausgeführt wird, nicht über die Berechtigung für den 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 für den Download der Daten.

fileName

String

Der Name der lokalen Datei, die die Daten empfangen soll.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

WebException

Der durch Kombinieren von BaseAddress und address gebildete URI 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 gleichzeitig für mehrere Threads 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

Die DownloadFile -Methode lädt Daten aus dem durch im Parameter angegebenen URI in address eine lokale Datei herunter. Diese Methode blockiert beim Herunterladen der Ressource. Verwenden Sie eine der DownloadFileAsync Methoden, um eine Ressource herunterzuladen und die Ausführung fortzusetzen, während sie auf die Antwort des Servers warten.

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

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

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

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