Network.DownloadFile Yöntem

Başvuru

Tanım

Ad Alanı:: Microsoft.VisualBasic.Devices

Bütünleştirilmiş Kod:: Microsoft.VisualBasic.dll

Bütünleştirilmiş Kod:: Microsoft.VisualBasic.Forms.dll

Ö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 -> unit

Public 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

ArgumentException

destinationFileName sonunda eğik çizgiyle biter.

TimeoutException

Sunucu varsayılan zaman aşımı (100 saniye) içinde yanıt vermez.

SecurityException

Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.

WebException

İ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

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.

Ş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 -> unit

Public 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

ArgumentException

destinationFileName sonunda eğik çizgiyle biter.

TimeoutException

Sunucu varsayılan zaman aşımı (100 saniye) içinde yanıt vermez.

SecurityException

Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.

WebException

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

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

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.

Ş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 -> unit

Public 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

ArgumentException

destinationFileName sonunda eğik çizgiyle biter.

TimeoutException

Sunucu varsayılan zaman aşımı (100 saniye) içinde yanıt vermez.

SecurityException

Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.

WebException

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

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Açıklamalar

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

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.

Ş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 -> unit

Public 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

ArgumentException

destinationFileName sonunda eğik çizgiyle biter.

TimeoutException

Sunucu varsayılan zaman aşımı (100 saniye) içinde yanıt vermez.

SecurityException

Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.

WebException

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

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Açıklamalar

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

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.

Ş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 -> unit

Public 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

ArgumentException

destinationFileName sonunda eğik çizgiyle biter.

IOException

overwrite olarak ayarlanır False ve hedef dosya zaten var olur.

TimeoutException

Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.

SecurityException

Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.

WebException

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

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

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.

Ş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 -> unit

Public 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

ArgumentException

destinationFileName sonunda eğik çizgiyle biter.

IOException

overwrite olarak ayarlanır False ve hedef dosya zaten var olur.

TimeoutException

Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.

SecurityException

Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.

WebException

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

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Açıklamalar

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

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.

Ş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 -> unit

Public 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

ArgumentException

destinationFileName sondaki eğik çizgiyle biter.

IOException

overwrite olarak ayarlanır False ve hedef dosya zaten vardır.

TimeoutException

Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.

SecurityException

Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.

WebException

İ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

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

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.

Ş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 -> unit

Public 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

ArgumentException

destinationFileName sondaki eğik çizgiyle biter.

IOException

overwrite olarak ayarlanır False ve hedef dosya zaten vardır.

TimeoutException

Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.

SecurityException

Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.

WebException

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

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Açıklamalar

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

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.

Ş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 -> unit

Public 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

ArgumentException

destinationFileName sondaki eğik çizgiyle biter.

IOException

overwrite olarak ayarlanır False ve hedef dosya zaten vardır.

TimeoutException

Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.

SecurityException

Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.

WebException

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

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Açıklamalar

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

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.

Ş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 -> unit

Public 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

ArgumentException

destinationFileName sonunda eğik çizgiyle biter.

IOException

overwrite olarak ayarlanır False ve hedef dosya zaten var olur.

TimeoutException

Sunucu belirtilen connectionTimeoutiçinde yanıt vermiyor.

SecurityException

Kullanıcı bir ağ işlemi gerçekleştirmek için gerekli izinlere sahip değil.

WebException

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

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Açıklamalar

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

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.

Şunlara uygulanır

Aracılığıyla paylaş

Network.DownloadFile Yöntem

Tanım

Aşırı Yüklemeler

DownloadFile(String, String)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DownloadFile(Uri, String)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DownloadFile(String, String, String, String)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DownloadFile(Uri, String, String, String)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DownloadFile(String, String, String, String, Boolean, Int32, Boolean)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar