Udostępnij za pośrednictwem


Network.DownloadFile Metoda

Definicja

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

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

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

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

Żą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

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

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

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

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

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

Żą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

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

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

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

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

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

Żą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

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

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 .

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

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

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

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

Żą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

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

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 .

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

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

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

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

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

Żą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

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

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 .

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

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

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

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

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

Żą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

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

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 .

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

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

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

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

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

Żą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

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

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 .

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

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

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

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

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

Żą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

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

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 .

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

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

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

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

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

Żą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

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

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 .

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

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

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

Serwer nie odpowiada w ramach określonego connectionTimeoutelementu .

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

Żą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

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

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 .

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