Network.DownloadFile Method

Definition

Namespace:

Microsoft.VisualBasic.Devices

Assembly:

Microsoft.VisualBasic.Forms.dll

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

ArgumentException

destinationFileName ends with a trailing slash.

TimeoutException

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

SecurityException

User lacks necessary permissions to perform a network operation.

WebException

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

• Uri
• ICredentials
• Objects (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

ArgumentException

destinationFileName ends with a trailing slash.

TimeoutException

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

SecurityException

User lacks necessary permissions to perform a network operation.

WebException

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

• Uri
• ICredentials
• Objects (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

ArgumentException

destinationFileName ends with a trailing slash.

TimeoutException

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

SecurityException

User lacks necessary permissions to perform a network operation.

WebException

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

• Uri
• ICredentials
• Objects (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

ArgumentException

destinationFileName ends with a trailing slash.

TimeoutException

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

SecurityException

User lacks necessary permissions to perform a network operation.

WebException

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

• Uri
• ICredentials
• Objects (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

ArgumentException

destinationFileName ends with a trailing slash.

IOException

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

TimeoutException

The server does not respond within the specified connectionTimeout.

SecurityException

User lacks necessary permissions to perform a network operation.

WebException

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

• Uri
• ICredentials
• Objects (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

ArgumentException

destinationFileName ends with a trailing slash.

IOException

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

TimeoutException

The server does not respond within the specified connectionTimeout.

SecurityException

User lacks necessary permissions to perform a network operation.

WebException

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

• Uri
• ICredentials
• Objects (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

ArgumentException

destinationFileName ends with a trailing slash.

IOException

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

TimeoutException

The server does not respond within the specified connectionTimeout.

SecurityException

User lacks necessary permissions to perform a network operation.

WebException

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

• Uri
• ICredentials
• Objects (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

ArgumentException

destinationFileName ends with a trailing slash.

IOException

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

TimeoutException

The server does not respond within the specified connectionTimeout.

SecurityException

User lacks necessary permissions to perform a network operation.

WebException

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

• Uri
• ICredentials
• Objects (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

ArgumentException

destinationFileName ends with a trailing slash.

IOException

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

TimeoutException

The server does not respond within the specified connectionTimeout.

SecurityException

User lacks necessary permissions to perform a network operation.

WebException

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

• Uri
• ICredentials
• Objects (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

ArgumentException

destinationFileName ends with a trailing slash.

IOException

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

TimeoutException

The server does not respond within the specified connectionTimeout.

SecurityException

User lacks necessary permissions to perform a network operation.

WebException

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

• Uri
• ICredentials
• Objects (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic