WebClient.DownloadFile Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Sumber:
- WebClient.cs
- 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
- fileName
- String
Nama file lokal yang akan menerima data.
Pengecualian
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.
Metode ini telah dipanggil secara bersamaan pada beberapa utas.
Keterangan
Metode ini 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 digabungkan 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.
Berlaku untuk
DownloadFile(String, String)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- 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
Parameternya address
adalah null
.
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.
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 ini 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 digabungkan 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.
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk