Network.DownloadFile Metod

Definition

Namnområde:: Microsoft.VisualBasic.Devices

Sammansättning:: Microsoft.VisualBasic.dll

Sammansättning:: Microsoft.VisualBasic.Forms.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

Överlagringar

Name	Description
DownloadFile(String, String)	Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.
DownloadFile(Uri, String)	Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.
DownloadFile(String, String, String, String)	Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.
DownloadFile(Uri, String, String, String)	Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)	Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)	Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)	Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)	Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

DownloadFile(String, String)

Källa:: Network.DownloadFile.vb

Källa:: Network.DownloadFile.vb

Källa:: Network.vb

Källa:: Network.vb

Källa:: Network.vb

Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

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)

Parametrar

address: String

Sökväg till filen som ska laddas ned, inklusive filnamn och värdadress.

destinationFileName: String

Filnamn och sökväg för den nedladdade filen.

Undantag

ArgumentException

destinationFileName slutar med ett avslutande snedstreck.

TimeoutException

Servern svarar inte inom standardtimeouten (100 sekunder).

SecurityException

Användaren saknar nödvändiga behörigheter för att utföra en nätverksåtgärd.

WebException

Begäran nekas av målwebbservern.

Exempel

Det här exemplet laddar ned filen WineList.txt från http://www.cohowinery.com/downloads och sparar den till 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")

I det här exemplet laddas filen WineList.txt ned från http://www.cohowinery.com/downloads och sparas till C:\Documents and Settings\All Users\Documents, vilket anger ett tidsgränsintervall på 500 millisekunder.

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

Kommentarer

DownloadFile utdata spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Aktivera nätverksspårning.

Note

Metoden DownloadFile skickar inte valfria HTTP-huvuden. Vissa servrar kan returnera 500 (internt serverfel) om det valfria användaragenthuvudet saknas. Om du vill skicka valfria rubriker måste du skapa en begäran med hjälp av WebClient klassen .

I följande tabell visas ett exempel på en uppgift som involverar My.Computer.Network.DownloadFile metoden.

Till	Se
Ladda ned en fil	Gör så här: Ladda ned en fil

Se även

Gäller för

DownloadFile(Uri, String)

Källa:: Network.DownloadFile.vb

Källa:: Network.DownloadFile.vb

Källa:: Network.vb

Källa:: Network.vb

Källa:: Network.vb

Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

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)

Parametrar

address: Uri

Sökväg till filen som ska laddas ned, inklusive filnamn och värdadress.

destinationFileName: String

Filnamn och sökväg för den nedladdade filen.

Undantag

ArgumentException

destinationFileName slutar med ett avslutande snedstreck.

TimeoutException

Servern svarar inte inom standardtimeouten (100 sekunder).

SecurityException

Användaren saknar nödvändiga behörigheter för att utföra en nätverksåtgärd.

WebException

Begäran nekas av målwebbservern.

Exempel

Det här exemplet laddar ned filen WineList.txt från http://www.cohowinery.com/downloads och sparar den till 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)

Kommentarer

Om målfilen redan finns DownloadFile skriver metoden inte över den befintliga filen. Du kan använda någon av de andra överlagringarna av metoden för att instruera den DownloadFile att skriva över befintliga filer, ange användarautentiseringsuppgifter eller ange ett specifikt timeout-värde. DownloadFile utdata spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Aktivera nätverksspårning.

Note

I följande tabell visas ett exempel på en uppgift som involverar My.Computer.Network.DownloadFile metoden.

Till	Se
Ladda ned en fil	Gör så här: Ladda ned en fil

Se även

Gäller för

DownloadFile(String, String, String, String)

Källa:: Network.DownloadFile.vb

Källa:: Network.DownloadFile.vb

Källa:: Network.vb

Källa:: Network.vb

Källa:: Network.vb

Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

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)

Parametrar

address: String

Sökväg till filen som ska laddas ned, inklusive filnamn och värdadress.

destinationFileName: String

Filnamn och sökväg för den nedladdade filen.

userName: String

Användarnamn som ska autentiseras. Standardvärdet är en tom sträng, "".

password: String

Lösenord för att autentisera. Standardvärdet är en tom sträng, "".

Undantag

ArgumentException

destinationFileName slutar med ett avslutande snedstreck.

TimeoutException

Servern svarar inte inom standardtimeouten (100 sekunder).

SecurityException

Användaren saknar nödvändiga behörigheter för att utföra en nätverksåtgärd.

WebException

Begäran nekas av målwebbservern.

Exempel

Det här exemplet laddar ned filen WineList.txt från http://www.cohowinery.com/downloads och sparar den till 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)

Kommentarer

DownloadFile utdata spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Aktivera nätverksspårning.

Note

FTP-protokollet skickar information, inklusive lösenord, i oformaterad text och bör inte användas för att överföra känslig information.

I följande tabell visas ett exempel på en uppgift som involverar My.Computer.Network.DownloadFile metoden.

Till	Se
Ladda ned en fil	Gör så här: Ladda ned en fil

Se även

Gäller för

DownloadFile(Uri, String, String, String)

Källa:: Network.DownloadFile.vb

Källa:: Network.DownloadFile.vb

Källa:: Network.vb

Källa:: Network.vb

Källa:: Network.vb

Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

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)

Parametrar

address: Uri

Sökväg till filen som ska laddas ned, inklusive filnamn och värdadress.

destinationFileName: String

Filnamn och sökväg för den nedladdade filen.

userName: String

Användarnamn som ska autentiseras. Standardvärdet är en tom sträng, "".

password: String

Lösenord för att autentisera. Standardvärdet är en tom sträng, "".

Undantag

ArgumentException

destinationFileName slutar med ett avslutande snedstreck.

TimeoutException

Servern svarar inte inom standardtimeouten (100 sekunder).

SecurityException

Användaren saknar nödvändiga behörigheter för att utföra en nätverksåtgärd.

WebException

Begäran nekas av målwebbservern.

Exempel

Det här exemplet laddar ned filen WineList.txt från http://www.cohowinery.com/downloads och sparar den till 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)

Kommentarer

DownloadFile utdata spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Aktivera nätverksspårning.

Note

FTP-protokollet skickar information, inklusive lösenord, i oformaterad text och bör inte användas för att överföra känslig information.

I följande tabell visas ett exempel på en uppgift som involverar My.Computer.Network.DownloadFile metoden.

Till	Se
Ladda ned en fil	Gör så här: Ladda ned en fil

Se även

Gäller för

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

Källa:: Network.DownloadFile.vb

Källa:: Network.DownloadFile.vb

Källa:: Network.vb

Källa:: Network.vb

Källa:: Network.vb

Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

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)

Parametrar

address: Uri

String eller Uri. Sökväg till filen som ska laddas ned, inklusive filnamn och värdadress.

destinationFileName: String

String. Filnamn och sökväg för den nedladdade filen.

networkCredentials: ICredentials

ICredentials. Autentiseringsuppgifter som ska anges.

showUI: Boolean

True för att visa förloppet för åtgärden. annars False. Standard är False.

connectionTimeout: Int32

Tidsgränsintervall i millisekunder. Standardvärdet är 100 sekunder.

overwrite: Boolean

True för att skriva över befintliga filer. annars False. Standard är False.

Undantag

ArgumentException

destinationFileName slutar med ett avslutande snedstreck.

IOException

overwrite är inställt på False och målfilen finns redan.

TimeoutException

Servern svarar inte inom angiven connectionTimeout.

SecurityException

Användaren saknar nödvändiga behörigheter för att utföra en nätverksåtgärd.

WebException

Begäran nekas av målwebbservern.

Exempel

Det här exemplet laddar ned filen WineList.txt från http://www.cohowinery.com/downloads och sparar den till 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)

Kommentarer

Om showUI är inställt på Truevisas en dialogruta som visar förloppet för åtgärden. Dialogrutan innehåller en Avbryt-knapp som kan användas för att avbryta åtgärden. Dialogrutan är inte modal och blockerar därför inte användarindata till andra fönster i programmet.

Om servern inte svarar inom angiven connectionTimeoutavbryts åtgärden och ett undantag utlöses.

DownloadFile utdata spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Aktivera nätverksspårning.

Note

FTP-protokollet skickar information, inklusive lösenord, i oformaterad text och bör inte användas för att överföra känslig information.

I följande tabell visas ett exempel på en uppgift som involverar My.Computer.Network.DownloadFile metoden.

Till	Se
Ladda ned en fil	Gör så här: Ladda ned en fil

Se även

Gäller för

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

Källa:: Network.DownloadFile.vb

Källa:: Network.DownloadFile.vb

Källa:: Network.vb

Källa:: Network.vb

Källa:: Network.vb

Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

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)

Parametrar

address: String

Sökväg till filen som ska laddas ned, inklusive filnamn och värdadress.

destinationFileName: String

Filnamn och sökväg för den nedladdade filen.

userName: String

Användarnamn som ska autentiseras. Standardvärdet är en tom sträng, "".

password: String

Lösenord för att autentisera. Standardvärdet är en tom sträng, "".

showUI: Boolean

True för att visa förloppet för åtgärden. annars False. Standard är False.

connectionTimeout: Int32

Int32. Tidsgränsintervall i millisekunder. Standardvärdet är 100 sekunder.

overwrite: Boolean

True för att skriva över befintliga filer. annars False. Standard är False.

Undantag

ArgumentException

destinationFileName slutar med ett avslutande snedstreck.

IOException

overwrite är inställt på False och målfilen finns redan.

TimeoutException

Servern svarar inte inom angiven connectionTimeout.

SecurityException

Användaren saknar nödvändiga behörigheter för att utföra en nätverksåtgärd.

WebException

Begäran nekas av målwebbservern.

Exempel

Det här exemplet laddar ned filen WineList.txt från http://www.cohowinery.com/downloads och sparar den till 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)

Kommentarer

Om servern inte svarar inom angiven connectionTimeoutavbryts åtgärden och ett undantag utlöses.

DownloadFile utdata spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Aktivera nätverksspårning.

Note

FTP-protokollet skickar information, inklusive lösenord, i oformaterad text och bör inte användas för att överföra känslig information.

I följande tabell visas ett exempel på en uppgift som involverar My.Computer.Network.DownloadFile metoden.

Till	Se
Ladda ned en fil	Gör så här: Ladda ned en fil

Se även

Gäller för

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

Källa:: Network.DownloadFile.vb

Källa:: Network.DownloadFile.vb

Källa:: Network.vb

Källa:: Network.vb

Källa:: Network.vb

Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

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)

Parametrar

address: Uri

Sökväg till filen som ska laddas ned, inklusive filnamn och värdadress.

destinationFileName: String

Filnamn och sökväg för den nedladdade filen.

networkCredentials: ICredentials

Autentiseringsuppgifter som ska anges.

showUI: Boolean

True för att visa förloppet för åtgärden. annars False. Standard är False.

connectionTimeout: Int32

Tidsgränsintervall i millisekunder. Standardvärdet är 100 sekunder.

overwrite: Boolean

True för att skriva över befintliga filer. annars False. Standard är False.

onUserCancel: UICancelOption

Anger beteende när användaren klickar på Avbryt eller Nej i dialogrutan som visas som ett resultat av showUI inställt på True. Standard är ThrowException.

Undantag

ArgumentException

destinationFileName slutar med ett avslutande snedstreck.

IOException

overwrite är inställt på False och målfilen finns redan.

TimeoutException

Servern svarar inte inom angiven connectionTimeout.

SecurityException

Användaren saknar nödvändiga behörigheter för att utföra en nätverksåtgärd.

WebException

Begäran nekas av målwebbservern.

Exempel

Det här exemplet laddar ned filen WineList.txt från http://www.cohowinery.com/downloads och sparar den till 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)

Kommentarer

Om servern inte svarar inom angiven connectionTimeoutavbryts åtgärden och ett undantag utlöses.

DownloadFile utdata spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Aktivera nätverksspårning.

Note

FTP-protokollet skickar information, inklusive lösenord, i oformaterad text och bör inte användas för att överföra känslig information.

I följande tabell visas ett exempel på en uppgift som involverar My.Computer.Network.DownloadFile metoden.

Till	Se
Ladda ned en fil	Gör så här: Ladda ned en fil

Se även

Gäller för

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

Källa:: Network.DownloadFile.vb

Källa:: Network.DownloadFile.vb

Källa:: Network.vb

Källa:: Network.vb

Källa:: Network.vb

Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

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)

Parametrar

address: Uri

Sökväg till filen som ska laddas ned, inklusive filnamn och värdadress.

destinationFileName: String

Filnamn och sökväg för den nedladdade filen.

userName: String

Användarnamn som ska autentiseras. Standardvärdet är en tom sträng, "".

password: String

Lösenord för att autentisera. Standardvärdet är en tom sträng, "".

showUI: Boolean

True för att visa förloppet för åtgärden. annars False. Standard är False.

connectionTimeout: Int32

Tidsgränsintervall i millisekunder. Standardvärdet är 100 sekunder.

overwrite: Boolean

True för att skriva över befintliga filer. annars False. Standard är False.

Undantag

ArgumentException

destinationFileName slutar med ett avslutande snedstreck.

IOException

overwrite är inställt på False och målfilen finns redan.

TimeoutException

Servern svarar inte inom angiven connectionTimeout.

SecurityException

Användaren saknar nödvändiga behörigheter för att utföra en nätverksåtgärd.

WebException

Begäran nekas av målwebbservern.

Exempel

Det här exemplet laddar ned filen WineList.txt från http://www.cohowinery.com/downloads och sparar den till 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)

Kommentarer

Om servern inte svarar inom angiven connectionTimeoutavbryts åtgärden och ett undantag utlöses.

DownloadFile utdata spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Aktivera nätverksspårning.

Note

FTP-protokollet skickar information, inklusive lösenord, i oformaterad text och bör inte användas för att överföra känslig information.

I följande tabell visas ett exempel på en uppgift som involverar My.Computer.Network.DownloadFile metoden.

Till	Se
Ladda ned en fil	Gör så här: Ladda ned en fil

Se även

Gäller för

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

Källa:: Network.DownloadFile.vb

Källa:: Network.DownloadFile.vb

Källa:: Network.vb

Källa:: Network.vb

Källa:: Network.vb

Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

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)

Parametrar

address: String

Sökväg till filen som ska laddas ned, inklusive filnamn och värdadress.

destinationFileName: String

Filnamn och sökväg för den nedladdade filen.

userName: String

Användarnamn som ska autentiseras. Standardvärdet är en tom sträng, "".

password: String

Lösenord för att autentisera. Standardvärdet är en tom sträng, "".

showUI: Boolean

True för att visa förloppet för åtgärden. annars False. Standard är False.

connectionTimeout: Int32

Tidsgränsintervall i millisekunder. Standardvärdet är 100 sekunder.

overwrite: Boolean

True för att skriva över befintliga filer. annars False. Standard är False.

onUserCancel: UICancelOption

Anger beteende när användaren klickar på Avbryt eller Nej i dialogrutan som visas som ett resultat av ShowUI inställt på True. Standard är ThrowException.

Undantag

ArgumentException

destinationFileName slutar med ett avslutande snedstreck.

IOException

overwrite är inställt på False och målfilen finns redan.

TimeoutException

Servern svarar inte inom angiven connectionTimeout.

SecurityException

Användaren saknar nödvändiga behörigheter för att utföra en nätverksåtgärd.

WebException

Begäran nekas av målwebbservern.

Exempel

Det här exemplet laddar ned filen WineList.txt från http://www.cohowinery.com/downloads och sparar den till 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)

Kommentarer

Om servern inte svarar inom angiven connectionTimeoutavbryts åtgärden och ett undantag utlöses.

DownloadFile utdata spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Aktivera nätverksspårning.

Note

FTP-protokollet skickar information, inklusive lösenord, i oformaterad text och bör inte användas för att överföra känslig information.

I följande tabell visas ett exempel på en uppgift som involverar My.Computer.Network.DownloadFile metoden.

Till	Se
Ladda ned en fil	Gör så här: Ladda ned en fil

Se även

Gäller för

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

Källa:: Network.DownloadFile.vb

Källa:: Network.DownloadFile.vb

Källa:: Network.vb

Källa:: Network.vb

Källa:: Network.vb

Laddar ned den angivna fjärrfilen och sparar den på den angivna platsen.

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)

Parametrar

address: Uri

Sökväg till filen som ska laddas ned, inklusive filnamn och värdadress.

destinationFileName: String

Filnamn och sökväg för den nedladdade filen.

userName: String

Användarnamn som ska autentiseras. Standardvärdet är en tom sträng, "".

password: String

Lösenord för att autentisera. Standardvärdet är en tom sträng, "".

showUI: Boolean

True för att visa förloppet för åtgärden. annars False. Standard är False.

connectionTimeout: Int32

Tidsgränsintervall i millisekunder. Standardvärdet är 100 sekunder.

overwrite: Boolean

True för att skriva över befintliga filer. annars False. Standard är False.

onUserCancel: UICancelOption

Anger beteende när användaren klickar på Avbryt eller Nej i dialogrutan som visas som ett resultat av ShowUI inställt på True. Standard är ThrowException.

Undantag

ArgumentException

destinationFileName slutar med ett avslutande snedstreck.

IOException

overwrite är inställt på False och målfilen finns redan.

TimeoutException

Servern svarar inte inom angiven connectionTimeout.

SecurityException

Användaren saknar nödvändiga behörigheter för att utföra en nätverksåtgärd.

WebException

Begäran nekas av målwebbservern.

Exempel

Det här exemplet laddar ned filen WineList.txt från http://www.cohowinery.com/downloads och sparar den till 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)

Kommentarer

Om servern inte svarar inom angiven connectionTimeoutavbryts åtgärden och ett undantag utlöses.

DownloadFile utdata spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Aktivera nätverksspårning.

Note

FTP-protokollet skickar information, inklusive lösenord, i oformaterad text och bör inte användas för att överföra känslig information.

I följande tabell visas ett exempel på en uppgift som involverar My.Computer.Network.DownloadFile metoden.

Till	Se
Ladda ned en fil	Gör så här: Ladda ned en fil

Se även

Gäller för

Feedback

Var den här sidan till hjälp?