WebClient.DownloadFile Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Pobiera zasób z określonym identyfikatorem URI do pliku lokalnego.

Przeciążenia

DownloadFile(Uri, String)	Pobiera zasób z określonym identyfikatorem URI do pliku lokalnego.
DownloadFile(String, String)	Pobiera zasób z określonym identyfikatorem URI do pliku lokalnego.

DownloadFile(Uri, String)

Źródło:

WebClient.cs

Pobiera zasób z określonym identyfikatorem URI do pliku lokalnego.

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

Identyfikator URI określony jako String, z którego mają być pobierane dane.

fileName

String

Nazwa pliku lokalnego, który ma odbierać dane.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr fileName jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

filename jest null lub Empty.

-lub-

Plik nie istnieje.

-lub-

Wystąpił błąd podczas pobierania danych.

NotSupportedException

Metoda została wywołana jednocześnie w wielu wątkach.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Metoda DownloadFile pobiera dane pliku lokalnego z identyfikatora URI określonego przez w parametrze address. Ta metoda blokuje pobieranie zasobu. Aby pobrać zasób i kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z metod DownloadFileAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

W przypadku korzystania z tej metody w aplikacji warstwy środkowej, takiej jak strona ASP.NET, zostanie wyświetlony błąd, jeśli konto, na którym jest wykonywana aplikacja, nie ma uprawnień dostępu do pliku.

DownloadFile(String, String)

Źródło:

WebClient.cs

Pobiera zasób z określonym identyfikatorem URI do pliku lokalnego.

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

Identyfikator URI, z którego mają być pobierane dane.

fileName

String

Nazwa pliku lokalnego, który ma odbierać dane.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

filename jest null lub Empty.

-lub-

Plik nie istnieje.

-or — Wystąpił błąd podczas pobierania danych.

NotSupportedException

Metoda została wywołana jednocześnie w wielu wątkach.

Przykłady

Poniższy przykład kodu pobiera plik z http://www.contoso.com na lokalny dysk twardy.

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

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Metoda DownloadFile pobiera dane pliku lokalnego z identyfikatora URI określonego przez w parametrze address. Ta metoda blokuje pobieranie zasobu. Aby pobrać zasób i kontynuować wykonywanie podczas oczekiwania na odpowiedź serwera, użyj jednej z metod DownloadFileAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

W przypadku korzystania z tej metody w aplikacji warstwy środkowej, takiej jak strona ASP.NET, zostanie wyświetlony błąd, jeśli konto, na którym jest wykonywana aplikacja, nie ma uprawnień dostępu do pliku.