Network.DownloadFile Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder.
Aşırı Yüklemeler
| DownloadFile(String, String) |
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder. |
| DownloadFile(Uri, String) |
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder. |
| DownloadFile(String, String, String, String) |
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder. |
| DownloadFile(Uri, String, String, String) |
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder. |
| DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean) |
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder. |
| DownloadFile(String, String, String, String, Boolean, Int32, Boolean) |
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder. |
| DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption) |
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder. |
| DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean) |
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder. |
| DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption) |
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder. |
| DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption) |
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder. |
DownloadFile(String, String)
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder.
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName);public void DownloadFile (string address, string destinationFileName);member this.DownloadFile : string * string -> unitPublic Sub DownloadFile (address As String, destinationFileName As String)Parametreler
- address
- String
dosya adı ve ana bilgisayar adresi de dahil olmak üzere indirilmesi gereken dosyanın yolu.
- destinationFileName
- String
İndirilen dosyanın dosya adı ve yolu.
Özel durumlar
destinationFileName sonunda eğik çizgiyle biter.
Sunucu varsayılan zaman aşımı (100 saniye) içinde yanıt vermez.
Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.
İstek hedef web sunucusu tarafından reddedilir.
Örnekler
Bu örnek, dosyasını WineList.txt uygulamasından http://www.cohowinery.com/downloads indirir ve dosyasına C:\Documents and Settings\All Users\Documentskaydeder.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
Bu örnek, dosyasından dosyasını WineList.txthttp://www.cohowinery.com/downloads indirir ve 500 milisaniyelik bir zaman aşımı aralığı belirterek dosyasına kaydeder C:\Documents and Settings\All Users\Documents.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Açıklamalar
Hedef dosya zaten varsa, DownloadFile yöntemi varolan dosyanın üzerine yazılmaz. Yöntemin diğer aşırı yüklemelerinden DownloadFile birini kullanarak mevcut dosyaların üzerine yazmasını, kullanıcı kimlik bilgilerini sağlamasını veya belirli bir zaman aşımı değerini belirtmesini bildirebilirsiniz.
DownloadFile , uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz . Ağ İzlemeyi Etkinleştirme.
Not
DownloadFile yöntemi isteğe bağlı HTTP üst bilgileri göndermez. İsteğe bağlı kullanıcı aracısı üst bilgisi eksikse bazı sunucular 500 (İç Sunucu Hatası) döndürebilir. İsteğe bağlı üst bilgiler göndermek için sınıfını WebClient kullanarak bir istek oluşturmanız gerekir.
Aşağıdaki tabloda, yöntemini içeren bir görev örneği liste verilmiştir My.Computer.Network.DownloadFile .
| Amaç | Bkz. |
|---|---|
| Dosya indirme | Nasıl yapılır: Dosya İndirme |
Ayrıca bkz.
- Uri
- ICredentials
- Nesneler (Visual Basic)
- Nasıl Yapılır: Visual Basic'te Dosya İndirme
- Nasıl Yapılır: Visual Basic'te Dosya Yollarını Ayrıştırma
Şunlara uygulanır
DownloadFile(Uri, String)
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName);public void DownloadFile (Uri address, string destinationFileName);member this.DownloadFile : Uri * string -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String)Parametreler
- address
- Uri
dosya adı ve ana bilgisayar adresi de dahil olmak üzere indirilmesi gereken dosyanın yolu.
- destinationFileName
- String
İndirilen dosyanın dosya adı ve yolu.
Özel durumlar
destinationFileName sonunda eğik çizgiyle biter.
Sunucu varsayılan zaman aşımı (100 saniye) içinde yanıt vermez.
Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.
İstek hedef web sunucusu tarafından reddedilir.
Örnekler
Bu örnek, dosyasını WineList.txt uygulamasından http://www.cohowinery.com/downloads indirir ve dosyasına C:\Documents and Settings\All Users\Documentskaydeder.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
Bu örnek, dosyasından dosyasını WineList.txthttp://www.cohowinery.com/downloads indirir ve 500 milisaniyelik bir zaman aşımı aralığı belirterek dosyasına kaydeder C:\Documents and Settings\All Users\Documents.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Açıklamalar
Hedef dosya zaten varsa, DownloadFile yöntemi varolan dosyanın üzerine yazılmaz. Yöntemin diğer aşırı yüklemelerinden DownloadFile birini kullanarak mevcut dosyaların üzerine yazmasını, kullanıcı kimlik bilgilerini sağlamasını veya belirli bir zaman aşımı değerini belirtmesini bildirebilirsiniz. DownloadFile , uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz . Ağ İzlemeyi Etkinleştirme.
Not
DownloadFile yöntemi isteğe bağlı HTTP üst bilgileri göndermez. İsteğe bağlı kullanıcı aracısı üst bilgisi eksikse bazı sunucular 500 (İç Sunucu Hatası) döndürebilir. İsteğe bağlı üst bilgiler göndermek için sınıfını WebClient kullanarak bir istek oluşturmanız gerekir.
Aşağıdaki tabloda, yöntemini içeren bir görev örneği liste verilmiştir My.Computer.Network.DownloadFile .
| Amaç | Bkz. |
|---|---|
| Dosya indirme | Nasıl yapılır: Dosya İndirme |
Ayrıca bkz.
- Uri
- ICredentials
- Nesneler (Visual Basic)
- Nasıl Yapılır: Visual Basic'te Dosya İndirme
- Nasıl Yapılır: Visual Basic'te Dosya Yollarını Ayrıştırma
Şunlara uygulanır
DownloadFile(String, String, String, String)
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder.
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);public void DownloadFile (string address, string destinationFileName, string userName, string password);member this.DownloadFile : string * string * string * string -> unitPublic Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String)Parametreler
- address
- String
dosya adı ve ana bilgisayar adresi de dahil olmak üzere indirilmesi gereken dosyanın yolu.
- destinationFileName
- String
İndirilen dosyanın dosya adı ve yolu.
- userName
- String
Kimlik doğrulaması için kullanıcı adı. Varsayılan boş bir dizedir, "".
- password
- String
Kimlik doğrulaması için parola. Varsayılan boş bir dizedir, "".
Özel durumlar
destinationFileName sonunda eğik çizgiyle biter.
Sunucu varsayılan zaman aşımı (100 saniye) içinde yanıt vermez.
Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.
İstek hedef web sunucusu tarafından reddedilir.
Örnekler
Bu örnek, dosyasını WineList.txt uygulamasından http://www.cohowinery.com/downloads indirir ve dosyasına C:\Documents and Settings\All Users\Documentskaydeder.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
Bu örnek, dosyasından dosyasını WineList.txthttp://www.cohowinery.com/downloads indirir ve 500 milisaniyelik bir zaman aşımı aralığı belirterek dosyasına kaydeder C:\Documents and Settings\All Users\Documents.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Açıklamalar
Hedef dosya zaten varsa, DownloadFile yöntemi varolan dosyanın üzerine yazılmaz. Yöntemin diğer aşırı yüklemelerinden DownloadFile birini kullanarak mevcut dosyaların üzerine yazmasını veya belirli bir zaman aşımı değerini belirtmesini sağlayabilirsiniz.
DownloadFile , uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz . Ağ İzlemeyi Etkinleştirme.
Not
DownloadFile yöntemi isteğe bağlı HTTP üst bilgileri göndermez. İsteğe bağlı kullanıcı aracısı üst bilgisi eksikse bazı sunucular 500 (İç Sunucu Hatası) döndürebilir. İsteğe bağlı üst bilgiler göndermek için sınıfını WebClient kullanarak bir istek oluşturmanız gerekir.
Not
FTP protokolü, parolalar da dahil olmak üzere bilgileri düz metin olarak gönderir ve hassas bilgileri iletmek için kullanılmamalıdır.
Aşağıdaki tabloda, yöntemini içeren bir görev örneği liste verilmiştir My.Computer.Network.DownloadFile .
| Amaç | Bkz. |
|---|---|
| Dosya indirme | Nasıl yapılır: Dosya İndirme |
Ayrıca bkz.
- Uri
- ICredentials
- Nesneler (Visual Basic)
- Nasıl Yapılır: Visual Basic'te Dosya İndirme
- Nasıl Yapılır: Visual Basic'te Dosya Yollarını Ayrıştırma
Şunlara uygulanır
DownloadFile(Uri, String, String, String)
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);public void DownloadFile (Uri address, string destinationFileName, string userName, string password);member this.DownloadFile : Uri * string * string * string -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String)Parametreler
- address
- Uri
dosya adı ve ana bilgisayar adresi de dahil olmak üzere indirilmesi gereken dosyanın yolu.
- destinationFileName
- String
İndirilen dosyanın dosya adı ve yolu.
- userName
- String
Kimlik doğrulaması için kullanıcı adı. Varsayılan boş bir dizedir, "".
- password
- String
Kimlik doğrulaması için parola. Varsayılan boş bir dizedir, "".
Özel durumlar
destinationFileName sonunda eğik çizgiyle biter.
Sunucu varsayılan zaman aşımı (100 saniye) içinde yanıt vermez.
Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.
İstek hedef web sunucusu tarafından reddedilir.
Örnekler
Bu örnek, dosyasını WineList.txt uygulamasından http://www.cohowinery.com/downloads indirir ve dosyasına C:\Documents and Settings\All Users\Documentskaydeder.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
Bu örnek, dosyasından dosyasını WineList.txthttp://www.cohowinery.com/downloads indirir ve 500 milisaniyelik bir zaman aşımı aralığı belirterek dosyasına kaydeder C:\Documents and Settings\All Users\Documents.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Açıklamalar
Hedef dosya zaten varsa, DownloadFile yöntemi varolan dosyanın üzerine yazılmaz. Yöntemin diğer aşırı yüklemelerinden DownloadFile birini kullanarak mevcut dosyaların üzerine yazmasını veya belirli bir zaman aşımı değerini belirtmesini sağlayabilirsiniz.
DownloadFile , uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz . Ağ İzlemeyi Etkinleştirme.
Not
DownloadFile yöntemi isteğe bağlı HTTP üst bilgileri göndermez. İsteğe bağlı kullanıcı aracısı üst bilgisi eksikse bazı sunucular 500 (İç Sunucu Hatası) döndürebilir. İsteğe bağlı üst bilgiler göndermek için sınıfını WebClient kullanarak bir istek oluşturmanız gerekir.
Not
FTP protokolü, parolalar da dahil olmak üzere bilgileri düz metin olarak gönderir ve hassas bilgileri iletmek için kullanılmamalıdır.
Aşağıdaki tabloda, yöntemini içeren bir görev örneği liste verilmiştir My.Computer.Network.DownloadFile .
| Amaç | Bkz. |
|---|---|
| Dosya indirme | Nasıl yapılır: Dosya İndirme |
Ayrıca bkz.
- Uri
- ICredentials
- Nesneler (Visual Basic)
- Nasıl Yapılır: Visual Basic'te Dosya İndirme
- Nasıl Yapılır: Visual Basic'te Dosya Yollarını Ayrıştırma
Şunlara uygulanır
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite);public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite);member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)Parametreler
- address
- Uri
String veya Uri. dosya adı ve ana bilgisayar adresi de dahil olmak üzere indirilmesi gereken dosyanın yolu.
- destinationFileName
- String
String. İndirilen dosyanın dosya adı ve yolu.
- networkCredentials
- ICredentials
ICredentials. Sağlanacak kimlik bilgileri.
- showUI
- Boolean
True işlemin ilerleme durumunu görüntülemek için; aksi takdirde False. False varsayılan değerdir.
- connectionTimeout
- Int32
Milisaniye cinsinden zaman aşımı aralığı. Varsayılan değer 100 saniyedir.
- overwrite
- Boolean
True varolan dosyaların üzerine yazmak için; aksi takdirde False. False varsayılan değerdir.
Özel durumlar
destinationFileName sonunda eğik çizgiyle biter.
overwrite olarak ayarlanır False ve hedef dosya zaten var olur.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.
Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.
İstek hedef web sunucusu tarafından reddedilir.
Örnekler
Bu örnek, dosyasını WineList.txt uygulamasından http://www.cohowinery.com/downloads indirir ve dosyasına C:\Documents and Settings\All Users\Documentskaydeder.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
Bu örnek, dosyasından dosyasını WineList.txthttp://www.cohowinery.com/downloads indirir ve 500 milisaniyelik bir zaman aşımı aralığı belirterek dosyasına kaydeder C:\Documents and Settings\All Users\Documents.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Açıklamalar
olarak ayarlanırsa showUITrue, işlemin ilerleme durumunu gösteren bir iletişim kutusu görüntülenir; iletişim kutusunda işlemi iptal etmek için kullanılabilecek bir İptal düğmesi bulunur. İletişim kutusu kalıcı değildir ve bu nedenle programdaki diğer pencerelere kullanıcı girişini engellemez.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermezse, işlem iptal edilir ve bir özel durum oluşturulur.
DownloadFile , uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz . Ağ İzlemeyi Etkinleştirme.
Not
DownloadFile yöntemi isteğe bağlı HTTP üst bilgileri göndermez. İsteğe bağlı kullanıcı aracısı üst bilgisi eksikse bazı sunucular 500 (İç Sunucu Hatası) döndürebilir. İsteğe bağlı üst bilgiler göndermek için sınıfını WebClient kullanarak bir istek oluşturmanız gerekir.
Not
FTP protokolü, parolalar da dahil olmak üzere bilgileri düz metin olarak gönderir ve hassas bilgileri iletmek için kullanılmamalıdır.
Aşağıdaki tabloda, yöntemini içeren bir görev örneği liste verilmiştir My.Computer.Network.DownloadFile .
| Amaç | Bkz. |
|---|---|
| Dosya indirme | Nasıl yapılır: Dosya İndirme |
Ayrıca bkz.
- Uri
- ICredentials
- Nesneler (Visual Basic)
- Nasıl Yapılır: Visual Basic'te Dosya İndirme
- Nasıl Yapılır: Visual Basic'te Dosya Yollarını Ayrıştırma
Şunlara uygulanır
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder.
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);member this.DownloadFile : string * string * string * string * bool * int * bool -> unitPublic Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)Parametreler
- address
- String
dosya adı ve ana bilgisayar adresi de dahil olmak üzere indirilmesi gereken dosyanın yolu.
- destinationFileName
- String
İndirilen dosyanın dosya adı ve yolu.
- userName
- String
Kimlik doğrulaması için kullanıcı adı. Varsayılan boş bir dizedir, "".
- password
- String
Kimlik doğrulaması için parola. Varsayılan boş bir dizedir, "".
- showUI
- Boolean
True işlemin ilerleme durumunu görüntülemek için; aksi takdirde False. False varsayılan değerdir.
- connectionTimeout
- Int32
Int32. Milisaniye cinsinden zaman aşımı aralığı. Varsayılan değer 100 saniyedir.
- overwrite
- Boolean
True varolan dosyaların üzerine yazmak için; aksi takdirde False. False varsayılan değerdir.
Özel durumlar
destinationFileName sonunda eğik çizgiyle biter.
overwrite olarak ayarlanır False ve hedef dosya zaten var olur.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.
Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.
İstek hedef web sunucusu tarafından reddedilir.
Örnekler
Bu örnek, dosyasını WineList.txt uygulamasından http://www.cohowinery.com/downloads indirir ve dosyasına C:\Documents and Settings\All Users\Documentskaydeder.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
Bu örnek, dosyasından dosyasını WineList.txthttp://www.cohowinery.com/downloads indirir ve 500 milisaniyelik bir zaman aşımı aralığı belirterek dosyasına kaydeder C:\Documents and Settings\All Users\Documents.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Açıklamalar
olarak ayarlanırsa showUITrue, işlemin ilerleme durumunu gösteren bir iletişim kutusu görüntülenir; iletişim kutusunda işlemi iptal etmek için kullanılabilecek bir İptal düğmesi bulunur. İletişim kutusu kalıcı değildir ve bu nedenle programdaki diğer pencerelere kullanıcı girişini engellemez.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermezse, işlem iptal edilir ve bir özel durum oluşturulur.
DownloadFile , uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz . Ağ İzlemeyi Etkinleştirme.
Not
DownloadFile yöntemi isteğe bağlı HTTP üst bilgileri göndermez. İsteğe bağlı kullanıcı aracısı üst bilgisi eksikse bazı sunucular 500 (İç Sunucu Hatası) döndürebilir. İsteğe bağlı üst bilgiler göndermek için sınıfını WebClient kullanarak bir istek oluşturmanız gerekir.
Not
FTP protokolü, parolalar dahil olmak üzere bilgileri düz metin olarak gönderir ve hassas bilgileri iletmek için kullanılmamalıdır.
Aşağıdaki tabloda, yöntemini içeren bir görev örneği listeledik My.Computer.Network.DownloadFile .
| Amaç | Bkz. |
|---|---|
| Dosya indirme | Nasıl yapılır: Dosya İndirme |
Ayrıca bkz.
- Uri
- ICredentials
- Nesneler (Visual Basic)
- Nasıl Yapılır: Visual Basic'te Dosya İndirme
- Nasıl Yapılır: Visual Basic'te Dosya Yollarını Ayrıştırma
Şunlara uygulanır
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)Parametreler
- address
- Uri
Dosya adı ve ana bilgisayar adresi de dahil olmak üzere indirilmesi gereken dosyanın yolu.
- destinationFileName
- String
İndirilen dosyanın dosya adı ve yolu.
- networkCredentials
- ICredentials
Sağlanacak kimlik bilgileri.
- showUI
- Boolean
True işlemin ilerleme durumunu görüntülemek için; aksi takdirde False. False varsayılan değerdir.
- connectionTimeout
- Int32
Milisaniye cinsinden zaman aşımı aralığı. Varsayılan değer 100 saniyedir.
- overwrite
- Boolean
True varolan dosyaların üzerine yazmak için; aksi takdirde False. False varsayılan değerdir.
- onUserCancel
- UICancelOption
Kullanıcı olarak ayarlandığında gösterilen showUI iletişim kutusunda İptal'e veya Hayır'aTruetıkladığında davranışı belirtir. ThrowException varsayılan değerdir.
Özel durumlar
destinationFileName sondaki eğik çizgiyle biter.
overwrite olarak ayarlanır False ve hedef dosya zaten vardır.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.
Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.
İstek, hedef web sunucusu tarafından reddedilir.
Örnekler
Bu örnek, dosyasını WineList.txt uygulamasından http://www.cohowinery.com/downloads indirir ve dosyasına C:\Documents and Settings\All Users\Documentskaydeder.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
Bu örnek, 500 milisaniyelik bir zaman aşımı aralığı belirterek dosyasını WineList.txt öğesinden http://www.cohowinery.com/downloads indirir ve öğesine kaydeder C:\Documents and Settings\All Users\Documents.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Açıklamalar
olarak ayarlanırsa showUITrue, işlemin ilerleme durumunu gösteren bir iletişim kutusu görüntülenir; iletişim kutusunda işlemi iptal etmek için kullanılabilecek bir İptal düğmesi bulunur. İletişim kutusu kalıcı değildir ve bu nedenle programdaki diğer pencerelere kullanıcı girişini engellemez.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermezse işlem iptal edilir ve bir özel durum oluşur.
DownloadFile , uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. Ağ İzlemeyi Etkinleştirme.
Not
DownloadFile yöntemi isteğe bağlı HTTP üst bilgileri göndermez. İsteğe bağlı kullanıcı aracısı üst bilgisi eksikse bazı sunucular 500 (İç Sunucu Hatası) döndürebilir. İsteğe bağlı üst bilgiler göndermek için sınıfını WebClient kullanarak bir istek oluşturmanız gerekir.
Not
FTP protokolü, parolalar dahil olmak üzere bilgileri düz metin olarak gönderir ve hassas bilgileri iletmek için kullanılmamalıdır.
Aşağıdaki tabloda, yöntemini içeren bir görev örneği listeledik My.Computer.Network.DownloadFile .
| Amaç | Bkz. |
|---|---|
| Dosya indirme | Nasıl yapılır: Dosya İndirme |
Ayrıca bkz.
- Uri
- ICredentials
- Nesneler (Visual Basic)
- Nasıl Yapılır: Visual Basic'te Dosya İndirme
- Nasıl Yapılır: Visual Basic'te Dosya Yollarını Ayrıştırma
Şunlara uygulanır
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);member this.DownloadFile : Uri * string * string * string * bool * int * bool -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)Parametreler
- address
- Uri
Dosya adı ve ana bilgisayar adresi de dahil olmak üzere indirilmesi gereken dosyanın yolu.
- destinationFileName
- String
İndirilen dosyanın dosya adı ve yolu.
- userName
- String
Kimlik doğrulaması için kullanıcı adı. Varsayılan boş bir dizedir, "".
- password
- String
Kimlik doğrulaması için parola. Varsayılan boş bir dizedir, "".
- showUI
- Boolean
True işlemin ilerleme durumunu görüntülemek için; aksi takdirde False. False varsayılan değerdir.
- connectionTimeout
- Int32
Milisaniye cinsinden zaman aşımı aralığı. Varsayılan değer 100 saniyedir.
- overwrite
- Boolean
True varolan dosyaların üzerine yazmak için; aksi takdirde False. False varsayılan değerdir.
Özel durumlar
destinationFileName sondaki eğik çizgiyle biter.
overwrite olarak ayarlanır False ve hedef dosya zaten vardır.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.
Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.
İstek, hedef web sunucusu tarafından reddedilir.
Örnekler
Bu örnek, dosyasını WineList.txt uygulamasından http://www.cohowinery.com/downloads indirir ve dosyasına C:\Documents and Settings\All Users\Documentskaydeder.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
Bu örnek, 500 milisaniyelik bir zaman aşımı aralığı belirterek dosyasını WineList.txt öğesinden http://www.cohowinery.com/downloads indirir ve öğesine kaydeder C:\Documents and Settings\All Users\Documents.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Açıklamalar
olarak ayarlanırsa showUITrue, işlemin ilerleme durumunu gösteren bir iletişim kutusu görüntülenir; iletişim kutusunda işlemi iptal etmek için kullanılabilecek bir İptal düğmesi bulunur. İletişim kutusu kalıcı değildir ve bu nedenle programdaki diğer pencerelere kullanıcı girişini engellemez.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermezse işlem iptal edilir ve bir özel durum oluşur.
DownloadFile , uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. Ağ İzlemeyi Etkinleştirme.
Not
DownloadFile yöntemi isteğe bağlı HTTP üst bilgileri göndermez. İsteğe bağlı kullanıcı aracısı üst bilgisi eksikse bazı sunucular 500 (İç Sunucu Hatası) döndürebilir. İsteğe bağlı üst bilgiler göndermek için sınıfını WebClient kullanarak bir istek oluşturmanız gerekir.
Not
FTP protokolü, parolalar dahil olmak üzere bilgileri düz metin olarak gönderir ve hassas bilgileri iletmek için kullanılmamalıdır.
Aşağıdaki tabloda, yöntemini içeren bir görev örneği listeledik My.Computer.Network.DownloadFile .
| Amaç | Bkz. |
|---|---|
| Dosya indirme | Nasıl yapılır: Dosya İndirme |
Ayrıca bkz.
- Uri
- ICredentials
- Nesneler (Visual Basic)
- Nasıl Yapılır: Visual Basic'te Dosya İndirme
- Nasıl Yapılır: Visual Basic'te Dosya Yollarını Ayrıştırma
Şunlara uygulanır
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder.
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.DownloadFile : string * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)Parametreler
- address
- String
Dosya adı ve ana bilgisayar adresi de dahil olmak üzere indirilmesi gereken dosyanın yolu.
- destinationFileName
- String
İndirilen dosyanın dosya adı ve yolu.
- userName
- String
Kimlik doğrulaması için kullanıcı adı. Varsayılan boş bir dizedir, "".
- password
- String
Kimlik doğrulaması için parola. Varsayılan boş bir dizedir, "".
- showUI
- Boolean
True işlemin ilerleme durumunu görüntülemek için; aksi takdirde False. False varsayılan değerdir.
- connectionTimeout
- Int32
Milisaniye cinsinden zaman aşımı aralığı. Varsayılan değer 100 saniyedir.
- overwrite
- Boolean
True varolan dosyaların üzerine yazmak için; aksi takdirde False. False varsayılan değerdir.
- onUserCancel
- UICancelOption
Kullanıcı olarak ayarlandığında gösterilen ShowUI iletişim kutusunda İptal'e veya Hayır'aTruetıkladığında davranışı belirtir. ThrowException varsayılan değerdir.
Özel durumlar
destinationFileName sondaki eğik çizgiyle biter.
overwrite olarak ayarlanır False ve hedef dosya zaten vardır.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.
Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.
İstek, hedef web sunucusu tarafından reddedilir.
Örnekler
Bu örnek, dosyasını WineList.txt uygulamasından http://www.cohowinery.com/downloads indirir ve dosyasına C:\Documents and Settings\All Users\Documentskaydeder.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
Bu örnek, 500 milisaniyelik bir zaman aşımı aralığı belirterek dosyasını WineList.txt öğesinden http://www.cohowinery.com/downloads indirir ve öğesine kaydeder C:\Documents and Settings\All Users\Documents.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Açıklamalar
olarak ayarlanırsa showUITrue, işlemin ilerleme durumunu gösteren bir iletişim kutusu görüntülenir; iletişim kutusunda işlemi iptal etmek için kullanılabilecek bir İptal düğmesi bulunur. İletişim kutusu kalıcı değildir ve bu nedenle programdaki diğer pencerelere kullanıcı girişini engellemez.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermezse, işlem iptal edilir ve bir özel durum oluşturulur.
DownloadFile , uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz . Ağ İzlemeyi Etkinleştirme.
Not
DownloadFile yöntemi isteğe bağlı HTTP üst bilgileri göndermez. İsteğe bağlı kullanıcı aracısı üst bilgisi eksikse bazı sunucular 500 (İç Sunucu Hatası) döndürebilir. İsteğe bağlı üst bilgiler göndermek için sınıfını WebClient kullanarak bir istek oluşturmanız gerekir.
Not
FTP protokolü, parolalar da dahil olmak üzere bilgileri düz metin olarak gönderir ve hassas bilgileri iletmek için kullanılmamalıdır.
Aşağıdaki tabloda, yöntemini içeren bir görev örneği liste verilmiştir My.Computer.Network.DownloadFile .
| Amaç | Bkz. |
|---|---|
| Dosya indirme | Nasıl yapılır: Dosya İndirme |
Ayrıca bkz.
- Uri
- ICredentials
- Nesneler (Visual Basic)
- Nasıl Yapılır: Visual Basic'te Dosya İndirme
- Nasıl Yapılır: Visual Basic'te Dosya Yollarını Ayrıştırma
Şunlara uygulanır
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)
Belirtilen uzak dosyayı indirir ve belirtilen konuma kaydeder.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.DownloadFile : Uri * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)Parametreler
- address
- Uri
dosya adı ve ana bilgisayar adresi de dahil olmak üzere indirilmesi gereken dosyanın yolu.
- destinationFileName
- String
İndirilen dosyanın dosya adı ve yolu.
- userName
- String
Kimlik doğrulaması için kullanıcı adı. Varsayılan boş bir dizedir, "".
- password
- String
Kimlik doğrulaması için parola. Varsayılan boş bir dizedir, "".
- showUI
- Boolean
True işlemin ilerleme durumunu görüntülemek için; aksi takdirde False. False varsayılan değerdir.
- connectionTimeout
- Int32
Milisaniye cinsinden zaman aşımı aralığı. Varsayılan değer 100 saniyedir.
- overwrite
- Boolean
True varolan dosyaların üzerine yazmak için; aksi takdirde False. False varsayılan değerdir.
- onUserCancel
- UICancelOption
Kullanıcı olarak ayarlandığında gösterilen ShowUI iletişim kutusunda İptal'e veya Hayır'aTruetıkladığında davranışı belirtir. ThrowException varsayılan değerdir.
Özel durumlar
destinationFileName sonunda eğik çizgiyle biter.
overwrite olarak ayarlanır False ve hedef dosya zaten var olur.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.
Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.
İstek hedef web sunucusu tarafından reddedilir.
Örnekler
Bu örnek, dosyasını WineList.txt uygulamasından http://www.cohowinery.com/downloads indirir ve dosyasına C:\Documents and Settings\All Users\Documentskaydeder.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/WineList.txt",
"C:\Documents and Settings\All Users\Documents\WineList.txt")
Bu örnek, dosyasından dosyasını WineList.txthttp://www.cohowinery.com/downloads indirir ve 500 milisaniyelik bir zaman aşımı aralığı belirterek dosyasına kaydeder C:\Documents and Settings\All Users\Documents.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Açıklamalar
olarak ayarlanırsa showUITrue, işlemin ilerleme durumunu gösteren bir iletişim kutusu görüntülenir; iletişim kutusunda işlemi iptal etmek için kullanılabilecek bir İptal düğmesi bulunur. İletişim kutusu kalıcı değildir ve bu nedenle programdaki diğer pencerelere kullanıcı girişini engellemez.
Sunucu belirtilen connectionTimeoutiçinde yanıt vermezse, işlem iptal edilir ve bir özel durum oluşturulur.
DownloadFile , uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz . Ağ İzlemeyi Etkinleştirme.
Not
DownloadFile yöntemi isteğe bağlı HTTP üst bilgileri göndermez. İsteğe bağlı kullanıcı aracısı üst bilgisi eksikse bazı sunucular 500 (İç Sunucu Hatası) döndürebilir. İsteğe bağlı üst bilgiler göndermek için sınıfını WebClient kullanarak bir istek oluşturmanız gerekir.
Not
FTP protokolü, parolalar da dahil olmak üzere bilgileri düz metin olarak gönderir ve hassas bilgileri iletmek için kullanılmamalıdır.
Aşağıdaki tabloda, yöntemini içeren bir görev örneği liste verilmiştir My.Computer.Network.DownloadFile .
| Amaç | Bkz. |
|---|---|
| Dosya indirme | Nasıl yapılır: Dosya İndirme |
Ayrıca bkz.
- Uri
- ICredentials
- Nesneler (Visual Basic)
- Nasıl Yapılır: Visual Basic'te Dosya İndirme
- Nasıl Yapılır: Visual Basic'te Dosya Yollarını Ayrıştırma
Şunlara uygulanır
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin