Network.DownloadFile Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic.Devices

Zestaw:: Microsoft.VisualBasic.dll

Zestaw:: Microsoft.VisualBasic.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

Przeciążenia

DownloadFile(String, String)	Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.
DownloadFile(Uri, String)	Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.
DownloadFile(String, String, String, String)	Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.
DownloadFile(Uri, String, String, String)	Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)	Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)	Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)	Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)	Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

DownloadFile(String, String)

Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

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)

Parametry

address: String

Ścieżka pliku do pobrania, w tym nazwa pliku i adres hosta.

destinationFileName: String

Nazwa i ścieżka pobranego pliku.

Wyjątki

ArgumentException

destinationFileName kończy się ukośnikiem końcowym.

TimeoutException

Serwer nie odpowiada w ramach domyślnego limitu czasu (100 sekund).

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wykonania operacji sieciowej.

WebException

Żądanie jest odrzucane przez docelowy serwer internetowy.

Przykłady

Ten przykład pobiera plik WineList.txt z http://www.cohowinery.com/downloads pliku i zapisuje go w pliku C:\Documents and Settings\All Users\Documents.

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

W tym przykładzie plik WineList.txt jest pobierany z http://www.cohowinery.com/downloads pliku i zapisuje go w C:\Documents and Settings\All Users\Documentspliku , określając interwał limitu czasu wynoszący 500 milisekund.

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

Uwagi

DownloadFile program generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie śledzenia sieci.

Uwaga

Metoda DownloadFile nie wysyła opcjonalnych nagłówków HTTP. Niektóre serwery mogą zwracać wartość 500 (wewnętrzny błąd serwera), jeśli brakuje opcjonalnego nagłówka agenta użytkownika. Aby wysyłać opcjonalne nagłówki, należy utworzyć żądanie przy użyciu WebClient klasy .

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.Network.DownloadFile .

Działanie	Zobacz
Pobieranie pliku	Instrukcje: pobieranie pliku

Zobacz też

Dotyczy

DownloadFile(Uri, String)

Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

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)

Parametry

address: Uri

Ścieżka pliku do pobrania, w tym nazwa pliku i adres hosta.

destinationFileName: String

Nazwa i ścieżka pobranego pliku.

Wyjątki

ArgumentException

destinationFileName kończy się ukośnikiem końcowym.

TimeoutException

Serwer nie odpowiada w ramach domyślnego limitu czasu (100 sekund).

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wykonania operacji sieciowej.

WebException

Żądanie jest odrzucane przez docelowy serwer internetowy.

Przykłady

Ten przykład pobiera plik WineList.txt z http://www.cohowinery.com/downloads pliku i zapisuje go w pliku C:\Documents and Settings\All Users\Documents.

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)

Uwagi

Jeśli plik docelowy już istnieje, DownloadFile metoda nie zastąpi istniejącego pliku. Możesz użyć jednego z innych przeciążeń DownloadFile metody, aby poinstruować ją o zastąpieniu istniejących plików, podaniu poświadczeń użytkownika lub określeniu określonej wartości limitu czasu. DownloadFile program generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie śledzenia sieci.

Uwaga

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.Network.DownloadFile .

Działanie	Zobacz
Pobieranie pliku	Instrukcje: pobieranie pliku

Zobacz też

Dotyczy

DownloadFile(String, String, String, String)

Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

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)

Parametry

address: String

Ścieżka pliku do pobrania, w tym nazwa pliku i adres hosta.

destinationFileName: String

Nazwa i ścieżka pobranego pliku.

userName: String

Nazwa użytkownika do uwierzytelniania. Wartość domyślna to pusty ciąg "".

password: String

Hasło do uwierzytelniania. Wartość domyślna to pusty ciąg "".

Wyjątki

ArgumentException

destinationFileName kończy się ukośnikiem końcowym.

TimeoutException

Serwer nie odpowiada w ramach domyślnego limitu czasu (100 sekund).

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wykonania operacji sieciowej.

WebException

Żądanie jest odrzucane przez docelowy serwer internetowy.

Przykłady

Ten przykład pobiera plik WineList.txt z http://www.cohowinery.com/downloads pliku i zapisuje go w pliku C:\Documents and Settings\All Users\Documents.

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)

Uwagi

DownloadFile program generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie śledzenia sieci.

Uwaga

Protokół FTP wysyła informacje, w tym hasła, w postaci zwykłego tekstu i nie powinien być używany do przesyłania poufnych informacji.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.Network.DownloadFile .

Działanie	Zobacz
Pobieranie pliku	Instrukcje: pobieranie pliku

Zobacz też

Dotyczy

DownloadFile(Uri, String, String, String)

Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

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)

Parametry

address: Uri

Ścieżka pliku do pobrania, w tym nazwa pliku i adres hosta.

destinationFileName: String

Nazwa i ścieżka pobranego pliku.

userName: String

Nazwa użytkownika do uwierzytelniania. Wartość domyślna to pusty ciąg "".

password: String

Hasło do uwierzytelniania. Wartość domyślna to pusty ciąg "".

Wyjątki

ArgumentException

destinationFileName kończy się ukośnikiem końcowym.

TimeoutException

Serwer nie odpowiada w ramach domyślnego limitu czasu (100 sekund).

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wykonania operacji sieciowej.

WebException

Żądanie jest odrzucane przez docelowy serwer internetowy.

Przykłady

Ten przykład pobiera plik WineList.txt z http://www.cohowinery.com/downloads pliku i zapisuje go w pliku C:\Documents and Settings\All Users\Documents.

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)

Uwagi

DownloadFile program generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie śledzenia sieci.

Uwaga

Protokół FTP wysyła informacje, w tym hasła, w postaci zwykłego tekstu i nie powinien być używany do przesyłania poufnych informacji.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.Network.DownloadFile .

Działanie	Zobacz
Pobieranie pliku	Instrukcje: pobieranie pliku

Zobacz też

Dotyczy

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

Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

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)

Parametry

address: Uri

String lub Uri. Ścieżka pliku do pobrania, w tym nazwa pliku i adres hosta.

destinationFileName: String

String. Nazwa i ścieżka pobranego pliku.

networkCredentials: ICredentials

ICredentials. Poświadczenia do dostarczenia.

showUI: Boolean

True aby wyświetlić postęp operacji; w przeciwnym razie False. Wartość domyślna to False.

connectionTimeout: Int32

Interwał limitu czasu w milisekundach. Wartość domyślna to 100 sekund.

overwrite: Boolean

True aby zastąpić istniejące pliki; w przeciwnym razie False. Wartość domyślna to False.

Wyjątki

ArgumentException

destinationFileName kończy się ukośnikiem końcowym.

IOException

overwrite jest ustawiona na False , a plik docelowy już istnieje.

TimeoutException

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wykonania operacji sieciowej.

WebException

Żądanie jest odrzucane przez docelowy serwer internetowy.

Przykłady

Ten przykład pobiera plik WineList.txt z http://www.cohowinery.com/downloads pliku i zapisuje go w pliku C:\Documents and Settings\All Users\Documents.

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)

Uwagi

Jeśli showUI jest ustawiona wartość True, zostanie wyświetlone okno dialogowe pokazujące postęp operacji. Okno dialogowe zawiera przycisk Anuluj , którego można użyć do anulowania operacji. Okno dialogowe nie jest modalne i dlatego nie blokuje danych wejściowych użytkownika w innych oknach w programie.

Jeśli serwer nie odpowiada w ramach określonego connectionTimeoutobiektu , operacja zostanie anulowana i zostanie zgłoszony wyjątek.

DownloadFile program generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie śledzenia sieci.

Uwaga

Protokół FTP wysyła informacje, w tym hasła, w postaci zwykłego tekstu i nie powinien być używany do przesyłania poufnych informacji.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.Network.DownloadFile .

Działanie	Zobacz
Pobieranie pliku	Instrukcje: pobieranie pliku

Zobacz też

Dotyczy

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

Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

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)

Parametry

address: String

Ścieżka pliku do pobrania, w tym nazwa pliku i adres hosta.

destinationFileName: String

Nazwa i ścieżka pobranego pliku.

userName: String

Nazwa użytkownika do uwierzytelniania. Wartość domyślna to pusty ciąg "".

password: String

Hasło do uwierzytelniania. Wartość domyślna to pusty ciąg "".

showUI: Boolean

True aby wyświetlić postęp operacji; w przeciwnym razie False. Wartość domyślna to False.

connectionTimeout: Int32

Int32. Interwał limitu czasu w milisekundach. Wartość domyślna to 100 sekund.

overwrite: Boolean

True aby zastąpić istniejące pliki; w przeciwnym razie False. Wartość domyślna to False.

Wyjątki

ArgumentException

destinationFileName kończy się ukośnikiem końcowym.

IOException

overwrite jest ustawiona na False , a plik docelowy już istnieje.

TimeoutException

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wykonania operacji sieciowej.

WebException

Żądanie jest odrzucane przez docelowy serwer internetowy.

Przykłady

Ten przykład pobiera plik WineList.txt z http://www.cohowinery.com/downloads pliku i zapisuje go w pliku C:\Documents and Settings\All Users\Documents.

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)

Uwagi

Jeśli serwer nie odpowiada w ramach określonego connectionTimeoutobiektu , operacja zostanie anulowana i zostanie zgłoszony wyjątek.

DownloadFile program generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie śledzenia sieci.

Uwaga

Protokół FTP wysyła informacje, w tym hasła, w postaci zwykłego tekstu i nie powinien być używany do przesyłania poufnych informacji.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.Network.DownloadFile .

Działanie	Zobacz
Pobieranie pliku	Instrukcje: pobieranie pliku

Zobacz też

Dotyczy

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

Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

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)

Parametry

address: Uri

Ścieżka pliku do pobrania, w tym nazwa pliku i adres hosta.

destinationFileName: String

Nazwa i ścieżka pobranego pliku.

networkCredentials: ICredentials

Poświadczenia do dostarczenia.

showUI: Boolean

True aby wyświetlić postęp operacji; w przeciwnym razie False. Wartość domyślna to False.

connectionTimeout: Int32

Interwał limitu czasu w milisekundach. Wartość domyślna to 100 sekund.

overwrite: Boolean

True aby zastąpić istniejące pliki; w przeciwnym razie False. Wartość domyślna to False.

onUserCancel: UICancelOption

Określa zachowanie, gdy użytkownik kliknie przycisk Anuluj lub Nie w oknie dialogowym wyświetlanym w wyniku showUI ustawienia wartości True. Wartość domyślna to ThrowException.

Wyjątki

ArgumentException

destinationFileName kończy się ukośnikiem końcowym.

IOException

overwrite jest ustawiona na False , a plik docelowy już istnieje.

TimeoutException

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wykonania operacji sieciowej.

WebException

Żądanie jest odrzucane przez docelowy serwer internetowy.

Przykłady

Ten przykład pobiera plik WineList.txt z http://www.cohowinery.com/downloads pliku i zapisuje go w pliku C:\Documents and Settings\All Users\Documents.

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)

Uwagi

Jeśli serwer nie odpowiada w ramach określonego connectionTimeoutobiektu , operacja zostanie anulowana i zostanie zgłoszony wyjątek.

DownloadFile program generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie śledzenia sieci.

Uwaga

Protokół FTP wysyła informacje, w tym hasła, w postaci zwykłego tekstu i nie powinien być używany do przesyłania poufnych informacji.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.Network.DownloadFile .

Działanie	Zobacz
Pobieranie pliku	Instrukcje: pobieranie pliku

Zobacz też

Dotyczy

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

Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

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)

Parametry

address: Uri

Ścieżka pliku do pobrania, w tym nazwa pliku i adres hosta.

destinationFileName: String

Nazwa i ścieżka pobranego pliku.

userName: String

Nazwa użytkownika do uwierzytelniania. Wartość domyślna to pusty ciąg "".

password: String

Hasło do uwierzytelniania. Wartość domyślna to pusty ciąg "".

showUI: Boolean

True aby wyświetlić postęp operacji; w przeciwnym razie False. Wartość domyślna to False.

connectionTimeout: Int32

Interwał limitu czasu w milisekundach. Wartość domyślna to 100 sekund.

overwrite: Boolean

True aby zastąpić istniejące pliki; w przeciwnym razie False. Wartość domyślna to False.

Wyjątki

ArgumentException

destinationFileName kończy się ukośnikiem końcowym.

IOException

overwrite jest ustawiona na False , a plik docelowy już istnieje.

TimeoutException

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wykonania operacji sieciowej.

WebException

Żądanie jest odrzucane przez docelowy serwer internetowy.

Przykłady

Ten przykład pobiera plik WineList.txt z http://www.cohowinery.com/downloads pliku i zapisuje go w pliku C:\Documents and Settings\All Users\Documents.

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)

Uwagi

Jeśli serwer nie odpowiada w ramach określonego connectionTimeoutobiektu , operacja zostanie anulowana i zostanie zgłoszony wyjątek.

DownloadFile program generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie śledzenia sieci.

Uwaga

Protokół FTP wysyła informacje, w tym hasła, w postaci zwykłego tekstu i nie powinien być używany do przesyłania poufnych informacji.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.Network.DownloadFile .

Działanie	Zobacz
Pobieranie pliku	Instrukcje: pobieranie pliku

Zobacz też

Dotyczy

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

Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

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)

Parametry

address: String

Ścieżka pliku do pobrania, w tym nazwa pliku i adres hosta.

destinationFileName: String

Nazwa i ścieżka pobranego pliku.

userName: String

Nazwa użytkownika do uwierzytelniania. Wartość domyślna to pusty ciąg "".

password: String

Hasło do uwierzytelniania. Wartość domyślna to pusty ciąg "".

showUI: Boolean

True aby wyświetlić postęp operacji; w przeciwnym razie False. Wartość domyślna to False.

connectionTimeout: Int32

Interwał limitu czasu w milisekundach. Wartość domyślna to 100 sekund.

overwrite: Boolean

True aby zastąpić istniejące pliki; w przeciwnym razie False. Wartość domyślna to False.

onUserCancel: UICancelOption

Określa zachowanie, gdy użytkownik kliknie przycisk Anuluj lub Nie w oknie dialogowym wyświetlanym w wyniku ShowUI ustawienia wartości True. Wartość domyślna to ThrowException.

Wyjątki

ArgumentException

destinationFileName kończy się ukośnikiem końcowym.

IOException

overwrite jest ustawiona na False , a plik docelowy już istnieje.

TimeoutException

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wykonania operacji sieciowej.

WebException

Żądanie jest odrzucane przez docelowy serwer internetowy.

Przykłady

Ten przykład pobiera plik WineList.txt z http://www.cohowinery.com/downloads pliku i zapisuje go w pliku C:\Documents and Settings\All Users\Documents.

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)

Uwagi

Jeśli serwer nie odpowiada w ramach określonego connectionTimeoutobiektu , operacja zostanie anulowana i zostanie zgłoszony wyjątek.

DownloadFile program generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie śledzenia sieci.

Uwaga

Protokół FTP wysyła informacje, w tym hasła, w postaci zwykłego tekstu i nie powinien być używany do przesyłania poufnych informacji.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.Network.DownloadFile .

Działanie	Zobacz
Pobieranie pliku	Instrukcje: pobieranie pliku

Zobacz też

Dotyczy

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

Pobiera określony plik zdalny i zapisuje go w określonej lokalizacji.

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)

Parametry

address: Uri

Ścieżka pliku do pobrania, w tym nazwa pliku i adres hosta.

destinationFileName: String

Nazwa i ścieżka pobranego pliku.

userName: String

Nazwa użytkownika do uwierzytelniania. Wartość domyślna to pusty ciąg "".

password: String

Hasło do uwierzytelniania. Wartość domyślna to pusty ciąg "".

showUI: Boolean

True aby wyświetlić postęp operacji; w przeciwnym razie False. Wartość domyślna to False.

connectionTimeout: Int32

Interwał limitu czasu w milisekundach. Wartość domyślna to 100 sekund.

overwrite: Boolean

True aby zastąpić istniejące pliki; w przeciwnym razie False. Wartość domyślna to False.

onUserCancel: UICancelOption

Określa zachowanie, gdy użytkownik kliknie przycisk Anuluj lub Nie w oknie dialogowym wyświetlanym w wyniku ShowUI ustawienia wartości True. Wartość domyślna to ThrowException.

Wyjątki

ArgumentException

destinationFileName kończy się ukośnikiem końcowym.

IOException

overwrite jest ustawiona na False , a plik docelowy już istnieje.

TimeoutException

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wykonania operacji sieciowej.

WebException

Żądanie jest odrzucane przez docelowy serwer internetowy.

Przykłady

Ten przykład pobiera plik WineList.txt z http://www.cohowinery.com/downloads pliku i zapisuje go w pliku C:\Documents and Settings\All Users\Documents.

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)

Uwagi

Jeśli serwer nie odpowiada w ramach określonego connectionTimeoutobiektu , operacja zostanie anulowana i zostanie zgłoszony wyjątek.

DownloadFile program generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Włączanie śledzenia sieci.

Uwaga

Protokół FTP wysyła informacje, w tym hasła, w postaci zwykłego tekstu i nie powinien być używany do przesyłania poufnych informacji.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.Network.DownloadFile .

Działanie	Zobacz
Pobieranie pliku	Instrukcje: pobieranie pliku

Zobacz też

Dotyczy

Udostępnij za pośrednictwem

Network.DownloadFile Metoda

Definicja

Przeciążenia

DownloadFile(String, String)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

DownloadFile(Uri, String)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

DownloadFile(String, String, String, String)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

DownloadFile(Uri, String, String, String)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby