Network.DownloadFile Metoda
Definicja
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 -> unitPublic 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ż
- Uri
- ICredentials
- Obiekty (Visual Basic)
- Porady: pobieranie pliku w Visual Basic
- Porady: analizowanie ścieżek pliku w Visual Basic
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 -> unitPublic 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ż
- Uri
- ICredentials
- Obiekty (Visual Basic)
- Porady: pobieranie pliku w Visual Basic
- Porady: analizowanie ścieżek pliku w Visual Basic
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 -> unitPublic 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ż
- Uri
- ICredentials
- Obiekty (Visual Basic)
- Porady: pobieranie pliku w Visual Basic
- Porady: analizowanie ścieżek pliku w Visual Basic
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 -> unitPublic 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ż
- Uri
- ICredentials
- Obiekty (Visual Basic)
- Porady: pobieranie pliku w Visual Basic
- Porady: analizowanie ścieżek pliku w Visual Basic
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 -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)Parametry
- 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ż
- Uri
- ICredentials
- Obiekty (Visual Basic)
- Porady: pobieranie pliku w Visual Basic
- Porady: analizowanie ścieżek pliku w Visual Basic
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 -> unitPublic 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ż
- Uri
- ICredentials
- Obiekty (Visual Basic)
- Porady: pobieranie pliku w Visual Basic
- Porady: analizowanie ścieżek pliku w Visual Basic
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 -> unitPublic 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ż
- Uri
- ICredentials
- Obiekty (Visual Basic)
- Porady: pobieranie pliku w Visual Basic
- Porady: analizowanie ścieżek pliku w Visual Basic
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 -> unitPublic 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ż
- Uri
- ICredentials
- Obiekty (Visual Basic)
- Porady: pobieranie pliku w Visual Basic
- Porady: analizowanie ścieżek pliku w Visual Basic
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 -> unitPublic Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)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ż
- Uri
- ICredentials
- Obiekty (Visual Basic)
- Porady: pobieranie pliku w Visual Basic
- Porady: analizowanie ścieżek pliku w Visual Basic
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 -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)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ż
- Uri
- ICredentials
- Obiekty (Visual Basic)
- Porady: pobieranie pliku w Visual Basic
- Porady: analizowanie ścieżek pliku w Visual Basic
Dotyczy
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla