Edit

Share via


Network.DownloadFile Method

Definition

Downloads the specified remote file and saves it in the specified location.

Overloads

DownloadFile(String, String)

Downloads the specified remote file and saves it in the specified location.

DownloadFile(Uri, String)

Downloads the specified remote file and saves it in the specified location.

DownloadFile(String, String, String, String)

Downloads the specified remote file and saves it in the specified location.

DownloadFile(Uri, String, String, String)

Downloads the specified remote file and saves it in the specified location.

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

Downloads the specified remote file and saves it in the specified location.

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

Downloads the specified remote file and saves it in the specified location.

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

Downloads the specified remote file and saves it in the specified location.

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

Downloads the specified remote file and saves it in the specified location.

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

Downloads the specified remote file and saves it in the specified location.

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

Downloads the specified remote file and saves it in the specified location.

DownloadFile(String, String)

Downloads the specified remote file and saves it in the specified location.

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)

Parameters

address
String

Path of the file to download, including file name and host address.

destinationFileName
String

File name and path of the downloaded file.

Exceptions

destinationFileName ends with a trailing slash.

The server does not respond within the default timeout (100 seconds).

User lacks necessary permissions to perform a network operation.

The request is denied by the target web server.

Examples

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to 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")

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to C:\Documents and Settings\All Users\Documents, specifying a timeout interval of 500 milliseconds.

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

Remarks

If the destination file already exists, the DownloadFile method will not overwrite the existing file. You can use one of the other overloads of the DownloadFile method to instruct it to overwrite existing files, provide user credentials, or specify a specific timeout value.

DownloadFile outputs trace information when you enable network tracing in your application. For more information, see Enabling Network Tracing.

Note

The DownloadFile method does not send optional HTTP headers. Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. To send optional headers, you must construct a request using the WebClient class.

The following table lists an example of a task involving the My.Computer.Network.DownloadFile method.

To See
Download a file How to: Download a File

See also

Applies to

DownloadFile(Uri, String)

Downloads the specified remote file and saves it in the specified location.

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)

Parameters

address
Uri

Path of the file to download, including file name and host address.

destinationFileName
String

File name and path of the downloaded file.

Exceptions

destinationFileName ends with a trailing slash.

The server does not respond within the default timeout (100 seconds).

User lacks necessary permissions to perform a network operation.

The request is denied by the target web server.

Examples

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to 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")

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to C:\Documents and Settings\All Users\Documents, specifying a timeout interval of 500 milliseconds.

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

Remarks

If the destination file already exists, the DownloadFile method will not overwrite the existing file. You can use one of the other overloads of the DownloadFile method to instruct it to overwrite existing files, provide user credentials, or specify a specific timeout value. DownloadFile outputs trace information when you enable network tracing in your application. For more information, see Enabling Network Tracing.

Note

The DownloadFile method does not send optional HTTP headers. Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. To send optional headers, you must construct a request using the WebClient class.

The following table lists an example of a task involving the My.Computer.Network.DownloadFile method.

To See
Download a file How to: Download a File

See also

Applies to

DownloadFile(String, String, String, String)

Downloads the specified remote file and saves it in the specified location.

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)

Parameters

address
String

Path of the file to download, including file name and host address.

destinationFileName
String

File name and path of the downloaded file.

userName
String

User name to authenticate. Default is an empty string, "".

password
String

Password to authenticate. Default is an empty string, "".

Exceptions

destinationFileName ends with a trailing slash.

The server does not respond within the default timeout (100 seconds).

User lacks necessary permissions to perform a network operation.

The request is denied by the target web server.

Examples

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to 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")

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to C:\Documents and Settings\All Users\Documents, specifying a timeout interval of 500 milliseconds.

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

Remarks

If the destination file already exists, the DownloadFile method will not overwrite the existing file. You can use one of the other overloads of the DownloadFile method to instruct it to overwrite existing files or specify a specific timeout value.

DownloadFile outputs trace information when you enable network tracing in your application. For more information, see Enabling Network Tracing.

Note

The DownloadFile method does not send optional HTTP headers. Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. To send optional headers, you must construct a request using the WebClient class.

Note

The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

The following table lists an example of a task involving the My.Computer.Network.DownloadFile method.

To See
Download a file How to: Download a File

See also

Applies to

DownloadFile(Uri, String, String, String)

Downloads the specified remote file and saves it in the specified location.

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)

Parameters

address
Uri

Path of the file to download, including file name and host address.

destinationFileName
String

File name and path of the downloaded file.

userName
String

User name to authenticate. Default is an empty string, "".

password
String

Password to authenticate. Default is an empty string, "".

Exceptions

destinationFileName ends with a trailing slash.

The server does not respond within the default timeout (100 seconds).

User lacks necessary permissions to perform a network operation.

The request is denied by the target web server.

Examples

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to 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")

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to C:\Documents and Settings\All Users\Documents, specifying a timeout interval of 500 milliseconds.

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

Remarks

If the destination file already exists, the DownloadFile method will not overwrite the existing file. You can use one of the other overloads of the DownloadFile method to instruct it to overwrite existing files or specify a specific timeout value.

DownloadFile outputs trace information when you enable network tracing in your application. For more information, see Enabling Network Tracing.

Note

The DownloadFile method does not send optional HTTP headers. Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. To send optional headers, you must construct a request using the WebClient class.

Note

The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

The following table lists an example of a task involving the My.Computer.Network.DownloadFile method.

To See
Download a file How to: Download a File

See also

Applies to

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

Downloads the specified remote file and saves it in the specified location.

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)

Parameters

address
Uri

String or Uri. Path of the file to download, including file name and host address.

destinationFileName
String

String. File name and path of the downloaded file.

networkCredentials
ICredentials

ICredentials. Credentials to be supplied.

showUI
Boolean

True to display the progress of the operation; otherwise False. Default is False.

connectionTimeout
Int32

Timeout interval, in milliseconds. Default is 100 seconds.

overwrite
Boolean

True to overwrite existing files; otherwise False. Default is False.

Exceptions

destinationFileName ends with a trailing slash.

overwrite is set to False and the destination file already exists.

The server does not respond within the specified connectionTimeout.

User lacks necessary permissions to perform a network operation.

The request is denied by the target web server.

Examples

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to 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")

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to C:\Documents and Settings\All Users\Documents, specifying a timeout interval of 500 milliseconds.

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

Remarks

If showUI is set to True, a dialog box appears that shows the progress of the operation; the dialog box contains a Cancel button that can be used to cancel the operation. The dialog box is not modal, and therefore does not block user input to other windows in the program.

If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFile outputs trace information when you enable network tracing in your application. For more information, see Enabling Network Tracing.

Note

The DownloadFile method does not send optional HTTP headers. Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. To send optional headers, you must construct a request using the WebClient class.

Note

The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

The following table lists an example of a task involving the My.Computer.Network.DownloadFile method.

To See
Download a file How to: Download a File

See also

Applies to

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

Downloads the specified remote file and saves it in the specified location.

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)

Parameters

address
String

Path of the file to download, including file name and host address.

destinationFileName
String

File name and path of the downloaded file.

userName
String

User name to authenticate. Default is an empty string, "".

password
String

Password to authenticate. Default is an empty string, "".

showUI
Boolean

True to display the progress of the operation; otherwise False. Default is False.

connectionTimeout
Int32

Int32. Timeout interval, in milliseconds. Default is 100 seconds.

overwrite
Boolean

True to overwrite existing files; otherwise False. Default is False.

Exceptions

destinationFileName ends with a trailing slash.

overwrite is set to False and the destination file already exists.

The server does not respond within the specified connectionTimeout.

User lacks necessary permissions to perform a network operation.

The request is denied by the target web server.

Examples

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to 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")

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to C:\Documents and Settings\All Users\Documents, specifying a timeout interval of 500 milliseconds.

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

Remarks

If showUI is set to True, a dialog box appears that shows the progress of the operation; the dialog box contains a Cancel button that can be used to cancel the operation. The dialog box is not modal, and therefore does not block user input to other windows in the program.

If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFile outputs trace information when you enable network tracing in your application. For more information, see Enabling Network Tracing.

Note

The DownloadFile method does not send optional HTTP headers. Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. To send optional headers, you must construct a request using the WebClient class.

Note

The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

The following table lists an example of a task involving the My.Computer.Network.DownloadFile method.

To See
Download a file How to: Download a File

See also

Applies to

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

Downloads the specified remote file and saves it in the specified location.

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)

Parameters

address
Uri

Path of the file to download, including file name and host address.

destinationFileName
String

File name and path of the downloaded file.

networkCredentials
ICredentials

Credentials to be supplied.

showUI
Boolean

True to display the progress of the operation; otherwise False. Default is False.

connectionTimeout
Int32

Timeout interval, in milliseconds. Default is 100 seconds.

overwrite
Boolean

True to overwrite existing files; otherwise False. Default is False.

onUserCancel
UICancelOption

Specifies behavior when the user clicks Cancel or No on the dialog box shown as a result of showUI set to True. Default is ThrowException.

Exceptions

destinationFileName ends with a trailing slash.

overwrite is set to False and the destination file already exists.

The server does not respond within the specified connectionTimeout.

User lacks necessary permissions to perform a network operation.

The request is denied by the target web server.

Examples

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to 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")

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to C:\Documents and Settings\All Users\Documents, specifying a timeout interval of 500 milliseconds.

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

Remarks

If showUI is set to True, a dialog box appears that shows the progress of the operation; the dialog box contains a Cancel button that can be used to cancel the operation. The dialog box is not modal, and therefore does not block user input to other windows in the program.

If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFile outputs trace information when you enable network tracing in your application. For more information, see Enabling Network Tracing.

Note

The DownloadFile method does not send optional HTTP headers. Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. To send optional headers, you must construct a request using the WebClient class.

Note

The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

The following table lists an example of a task involving the My.Computer.Network.DownloadFile method.

To See
Download a file How to: Download a File

See also

Applies to

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

Downloads the specified remote file and saves it in the specified location.

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)

Parameters

address
Uri

Path of the file to download, including file name and host address.

destinationFileName
String

File name and path of the downloaded file.

userName
String

User name to authenticate. Default is an empty string, "".

password
String

Password to authenticate. Default is an empty string, "".

showUI
Boolean

True to display the progress of the operation; otherwise False. Default is False.

connectionTimeout
Int32

Timeout interval, in milliseconds. Default is 100 seconds.

overwrite
Boolean

True to overwrite existing files; otherwise False. Default is False.

Exceptions

destinationFileName ends with a trailing slash.

overwrite is set to False and the destination file already exists.

The server does not respond within the specified connectionTimeout.

User lacks necessary permissions to perform a network operation.

The request is denied by the target web server.

Examples

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to 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")

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to C:\Documents and Settings\All Users\Documents, specifying a timeout interval of 500 milliseconds.

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

Remarks

If showUI is set to True, a dialog box appears that shows the progress of the operation; the dialog box contains a Cancel button that can be used to cancel the operation. The dialog box is not modal, and therefore does not block user input to other windows in the program.

If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFile outputs trace information when you enable network tracing in your application. For more information, see Enabling Network Tracing.

Note

The DownloadFile method does not send optional HTTP headers. Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. To send optional headers, you must construct a request using the WebClient class.

Note

The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

The following table lists an example of a task involving the My.Computer.Network.DownloadFile method.

To See
Download a file How to: Download a File

See also

Applies to

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

Downloads the specified remote file and saves it in the specified location.

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)

Parameters

address
String

Path of the file to download, including file name and host address.

destinationFileName
String

File name and path of the downloaded file.

userName
String

User name to authenticate. Default is an empty string, "".

password
String

Password to authenticate. Default is an empty string, "".

showUI
Boolean

True to display the progress of the operation; otherwise False. Default is False.

connectionTimeout
Int32

Timeout interval, in milliseconds. Default is 100 seconds.

overwrite
Boolean

True to overwrite existing files; otherwise False. Default is False.

onUserCancel
UICancelOption

Specifies behavior when the user clicks Cancel or No on the dialog box shown as a result of ShowUI set to True. Default is ThrowException.

Exceptions

destinationFileName ends with a trailing slash.

overwrite is set to False and the destination file already exists.

The server does not respond within the specified connectionTimeout.

User lacks necessary permissions to perform a network operation.

The request is denied by the target web server.

Examples

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to 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")

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to C:\Documents and Settings\All Users\Documents, specifying a timeout interval of 500 milliseconds.

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

Remarks

If showUI is set to True, a dialog box appears that shows the progress of the operation; the dialog box contains a Cancel button that can be used to cancel the operation. The dialog box is not modal, and therefore does not block user input to other windows in the program.

If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFile outputs trace information when you enable network tracing in your application. For more information, see Enabling Network Tracing.

Note

The DownloadFile method does not send optional HTTP headers. Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. To send optional headers, you must construct a request using the WebClient class.

Note

The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

The following table lists an example of a task involving the My.Computer.Network.DownloadFile method.

To See
Download a file How to: Download a File

See also

Applies to

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

Downloads the specified remote file and saves it in the specified location.

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)

Parameters

address
Uri

Path of the file to download, including file name and host address.

destinationFileName
String

File name and path of the downloaded file.

userName
String

User name to authenticate. Default is an empty string, "".

password
String

Password to authenticate. Default is an empty string, "".

showUI
Boolean

True to display the progress of the operation; otherwise False. Default is False.

connectionTimeout
Int32

Timeout interval, in milliseconds. Default is 100 seconds.

overwrite
Boolean

True to overwrite existing files; otherwise False. Default is False.

onUserCancel
UICancelOption

Specifies behavior when the user clicks Cancel or No on the dialog box shown as a result of ShowUI set to True. Default is ThrowException.

Exceptions

destinationFileName ends with a trailing slash.

overwrite is set to False and the destination file already exists.

The server does not respond within the specified connectionTimeout.

User lacks necessary permissions to perform a network operation.

The request is denied by the target web server.

Examples

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to 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")

This example downloads the file WineList.txt from http://www.cohowinery.com/downloads and saves it to C:\Documents and Settings\All Users\Documents, specifying a timeout interval of 500 milliseconds.

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

Remarks

If showUI is set to True, a dialog box appears that shows the progress of the operation; the dialog box contains a Cancel button that can be used to cancel the operation. The dialog box is not modal, and therefore does not block user input to other windows in the program.

If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFile outputs trace information when you enable network tracing in your application. For more information, see Enabling Network Tracing.

Note

The DownloadFile method does not send optional HTTP headers. Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. To send optional headers, you must construct a request using the WebClient class.

Note

The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

The following table lists an example of a task involving the My.Computer.Network.DownloadFile method.

To See
Download a file How to: Download a File

See also

Applies to