WebClient.DownloadFile Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Mengunduh sumber daya dengan URI yang ditentukan ke file lokal.

Overload

DownloadFile(Uri, String)	Mengunduh sumber daya dengan URI yang ditentukan ke file lokal.
DownloadFile(String, String)	Mengunduh sumber daya dengan URI yang ditentukan ke file lokal.

DownloadFile(Uri, String)

Sumber:

WebClient.cs

Mengunduh sumber daya dengan URI yang ditentukan ke file lokal.

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

URI ditentukan sebagai String, tempat mengunduh data.

fileName

String

Nama file lokal yang akan menerima data.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya fileName adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

filename adalah null atau Empty.

-atau-

File tidak ada.

-atau-

Terjadi kesalahan saat mengunduh data.

NotSupportedException

Metode ini telah dipanggil secara bersamaan pada beberapa utas.

Keterangan

Metode DownloadFile mengunduh ke data file lokal dari URI yang ditentukan oleh dalam address parameter . Metode ini memblokir saat mengunduh sumber daya. Untuk mengunduh sumber daya dan terus mengeksekusi sambil menunggu respons server, gunakan salah DownloadFileAsync satu metode .

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Saat menggunakan metode ini di aplikasi tingkat menengah, seperti halaman ASP.NET, Anda akan menerima kesalahan jika akun tempat aplikasi dijalankan tidak memiliki izin untuk mengakses file.

DownloadFile(String, String)

Sumber:

WebClient.cs

Mengunduh sumber daya dengan URI yang ditentukan ke file lokal.

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

URI tempat mengunduh data.

fileName

String

Nama file lokal yang akan menerima data.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

filename adalah null atau Empty.

-atau-

File tidak ada.

-or- Terjadi kesalahan saat mengunduh data.

NotSupportedException

Metode ini telah dipanggil secara bersamaan pada beberapa utas.

Contoh

Contoh kode berikut mengunduh file dari http://www.contoso.com ke hard drive lokal.

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

Keterangan

Metode DownloadFile mengunduh ke data file lokal dari URI yang ditentukan oleh dalam address parameter . Metode ini memblokir saat mengunduh sumber daya. Untuk mengunduh sumber daya dan terus mengeksekusi sambil menunggu respons server, gunakan salah DownloadFileAsync satu metode .

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Saat menggunakan metode ini di aplikasi tingkat menengah, seperti halaman ASP.NET, Anda akan menerima kesalahan jika akun tempat aplikasi dijalankan tidak memiliki izin untuk mengakses file.