Network.DownloadFile Метод

Определение

Загружает указанный удаленный файл и сохраняет его в указанном местоположении.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.

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)

Параметры

address
String

Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.Path of the file to download, including file name and host address.

destinationFileName
String

Имя загружаемого файла и путь к нему.File name and path of the downloaded file.

Исключения

destinationFileName заканчивается косой чертой.destinationFileName ends with a trailing slash.

Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).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.

Примеры

В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется C:\Documents and Settings\All Users\Documentsв.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")

Этот пример скачивает файл WineList.txt из http://www.cohowinery.com/downloads и сохраняет его в C:\Documents and Settings\All Users\Documents, указывая интервал времени ожидания 500 миллисекунд.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)

Комментарии

Если конечный файл уже существует, DownloadFile метод не перезапишет существующий файл.If the destination file already exists, the DownloadFile method will not overwrite the existing file. Можно использовать одну из других перегрузок DownloadFile метода, чтобы сообщить ему о необходимости перезаписи существующих файлов, предоставить учетные данные пользователя или указать конкретное значение времени ожидания.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выводит сведения о трассировке при включении трассировки сети в приложении.DownloadFile outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе Включение трассировки сети.For more information, see Enabling Network Tracing.

Примечание

DownloadFile Метод не отправляет дополнительные заголовки HTTP.The DownloadFile method does not send optional HTTP headers. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если отсутствует заголовок необязательного агента пользователя.Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. Для отправки необязательных заголовков необходимо создать запрос с WebClient помощью класса.To send optional headers, you must construct a request using the WebClient class.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.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

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

WebPermission
Управляет правами доступа к интернет-ресурсам HTTP.Controls rights to access HTTP Internet resources. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

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)

Параметры

address
Uri

Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.Path of the file to download, including file name and host address.

destinationFileName
String

Имя загружаемого файла и путь к нему.File name and path of the downloaded file.

Исключения

destinationFileName заканчивается косой чертой.destinationFileName ends with a trailing slash.

Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).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.

Примеры

В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется C:\Documents and Settings\All Users\Documentsв.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")

Этот пример скачивает файл WineList.txt из http://www.cohowinery.com/downloads и сохраняет его в C:\Documents and Settings\All Users\Documents, указывая интервал времени ожидания 500 миллисекунд.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)

Комментарии

Если конечный файл уже существует, DownloadFile метод не перезапишет существующий файл.If the destination file already exists, the DownloadFile method will not overwrite the existing file. Можно использовать одну из других перегрузок DownloadFile метода, чтобы сообщить ему о необходимости перезаписи существующих файлов, предоставить учетные данные пользователя или указать конкретное значение времени ожидания.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выводит сведения о трассировке при включении трассировки сети в приложении.DownloadFile outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе Включение трассировки сети.For more information, see Enabling Network Tracing.

Примечание

DownloadFile Метод не отправляет дополнительные заголовки HTTP.The DownloadFile method does not send optional HTTP headers. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если отсутствует заголовок необязательного агента пользователя.Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. Для отправки необязательных заголовков необходимо создать запрос с WebClient помощью класса.To send optional headers, you must construct a request using the WebClient class.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.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

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

WebPermission
Управляет правами доступа к интернет-ресурсам HTTP.Controls rights to access HTTP Internet resources. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

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)

Параметры

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, "".

Исключения

destinationFileName заканчивается косой чертой.destinationFileName ends with a trailing slash.

Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).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.

Примеры

В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется C:\Documents and Settings\All Users\Documentsв.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")

Этот пример скачивает файл WineList.txt из http://www.cohowinery.com/downloads и сохраняет его в C:\Documents and Settings\All Users\Documents, указывая интервал времени ожидания 500 миллисекунд.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)

Комментарии

Если конечный файл уже существует, DownloadFile метод не перезапишет существующий файл.If the destination file already exists, the DownloadFile method will not overwrite the existing file. Можно использовать одну из других перегрузок DownloadFile метода, чтобы сообщить ему о необходимости перезаписи существующих файлов или указать определенное значение времени ожидания.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выводит сведения о трассировке при включении трассировки сети в приложении.DownloadFile outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе Включение трассировки сети.For more information, see Enabling Network Tracing.

Примечание

DownloadFile Метод не отправляет дополнительные заголовки HTTP.The DownloadFile method does not send optional HTTP headers. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если отсутствует заголовок необязательного агента пользователя.Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. Для отправки необязательных заголовков необходимо создать запрос с WebClient помощью класса.To send optional headers, you must construct a request using the WebClient class.

Примечание

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.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

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

WebPermission
Управляет правами доступа к интернет-ресурсам HTTP.Controls rights to access HTTP Internet resources. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

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)

Параметры

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, "".

Исключения

destinationFileName заканчивается косой чертой.destinationFileName ends with a trailing slash.

Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).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.

Примеры

В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется C:\Documents and Settings\All Users\Documentsв.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")

Этот пример скачивает файл WineList.txt из http://www.cohowinery.com/downloads и сохраняет его в C:\Documents and Settings\All Users\Documents, указывая интервал времени ожидания 500 миллисекунд.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)

Комментарии

Если конечный файл уже существует, DownloadFile метод не перезапишет существующий файл.If the destination file already exists, the DownloadFile method will not overwrite the existing file. Можно использовать одну из других перегрузок DownloadFile метода, чтобы сообщить ему о необходимости перезаписи существующих файлов или указать определенное значение времени ожидания.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выводит сведения о трассировке при включении трассировки сети в приложении.DownloadFile outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе Включение трассировки сети.For more information, see Enabling Network Tracing.

Примечание

DownloadFile Метод не отправляет дополнительные заголовки HTTP.The DownloadFile method does not send optional HTTP headers. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если отсутствует заголовок необязательного агента пользователя.Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. Для отправки необязательных заголовков необходимо создать запрос с WebClient помощью класса.To send optional headers, you must construct a request using the WebClient class.

Примечание

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.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

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

WebPermission
Управляет правами доступа к интернет-ресурсам HTTP.Controls rights to access HTTP Internet resources. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

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)

Параметры

address
Uri

String или Uri.String or Uri. Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.Path of the file to download, including file name and host address.

destinationFileName
String

String.String. Имя загружаемого файла и путь к нему.File name and path of the downloaded file.

networkCredentials
ICredentials

ICredentials.ICredentials. Учетные данные, которые необходимо предоставить.Credentials to be supplied.

showUI
Boolean

Значение True для отображения хода выполнения операции; в противном случае — значение False.True to display the progress of the operation; otherwise False. Значение по умолчанию — False.Default is False.

connectionTimeout
Int32

Интервал ожидания в миллисекундах.Timeout interval, in milliseconds. Значение по умолчанию — 100 секунд.Default is 100 seconds.

overwrite
Boolean

Значение True для перезаписи существующих файлов; в противном случае — значение False.True to overwrite existing files; otherwise False. Значение по умолчанию — False.Default is False.

Исключения

destinationFileName заканчивается косой чертой.destinationFileName ends with a trailing slash.

Для overwrite установлено значение False, а конечный файл уже существует.overwrite is set to False and the destination file already exists.

Сервер не отвечает в пределах указанного connectionTimeout.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.

Примеры

В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется C:\Documents and Settings\All Users\Documentsв.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")

Этот пример скачивает файл WineList.txt из http://www.cohowinery.com/downloads и сохраняет его в C:\Documents and Settings\All Users\Documents, указывая интервал времени ожидания 500 миллисекунд.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)

Комментарии

Если showUI параметр имеет Trueзначение, то отображается диалоговое окно, показывающее ход выполнения операции; диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции.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.

Если сервер не отвечает в течение указанного connectionTimeout, операция отменяется и создается исключение.If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFileвыводит сведения о трассировке при включении трассировки сети в приложении.DownloadFile outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе Включение трассировки сети.For more information, see Enabling Network Tracing.

Примечание

DownloadFile Метод не отправляет дополнительные заголовки HTTP.The DownloadFile method does not send optional HTTP headers. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если отсутствует заголовок необязательного агента пользователя.Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. Для отправки необязательных заголовков необходимо создать запрос с WebClient помощью класса.To send optional headers, you must construct a request using the WebClient class.

Примечание

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.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

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: AllWindows.Associated enumeration: AllWindows.

WebPermission
Управляет правами доступа к интернет-ресурсам HTTP.Controls rights to access HTTP Internet resources. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

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)

Параметры

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 для отображения хода выполнения операции; в противном случае — значение False.True to display the progress of the operation; otherwise False. Значение по умолчанию — False.Default is False.

connectionTimeout
Int32

Int32.Int32. Интервал ожидания в миллисекундах.Timeout interval, in milliseconds. Значение по умолчанию — 100 секунд.Default is 100 seconds.

overwrite
Boolean

Значение True для перезаписи существующих файлов; в противном случае — значение False.True to overwrite existing files; otherwise False. Значение по умолчанию — False.Default is False.

Исключения

destinationFileName заканчивается косой чертой.destinationFileName ends with a trailing slash.

Для overwrite установлено значение False, а конечный файл уже существует.overwrite is set to False and the destination file already exists.

Сервер не отвечает в пределах указанного connectionTimeout.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.

Примеры

В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется C:\Documents and Settings\All Users\Documentsв.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")

Этот пример скачивает файл WineList.txt из http://www.cohowinery.com/downloads и сохраняет его в C:\Documents and Settings\All Users\Documents, указывая интервал времени ожидания 500 миллисекунд.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)

Комментарии

Если showUI параметр имеет Trueзначение, то отображается диалоговое окно, показывающее ход выполнения операции; диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции.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.

Если сервер не отвечает в течение указанного connectionTimeout, операция отменяется и создается исключение.If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFileвыводит сведения о трассировке при включении трассировки сети в приложении.DownloadFile outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе Включение трассировки сети.For more information, see Enabling Network Tracing.

Примечание

DownloadFile Метод не отправляет дополнительные заголовки HTTP.The DownloadFile method does not send optional HTTP headers. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если отсутствует заголовок необязательного агента пользователя.Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. Для отправки необязательных заголовков необходимо создать запрос с WebClient помощью класса.To send optional headers, you must construct a request using the WebClient class.

Примечание

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.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

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: AllWindows.Associated enumeration: AllWindows.

WebPermission
Управляет правами доступа к интернет-ресурсам HTTP.Controls rights to access HTTP Internet resources. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

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)

Параметры

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 для отображения хода выполнения операции; в противном случае — значение False.True to display the progress of the operation; otherwise False. Значение по умолчанию — False.Default is False.

connectionTimeout
Int32

Интервал ожидания в миллисекундах.Timeout interval, in milliseconds. Значение по умолчанию — 100 секунд.Default is 100 seconds.

overwrite
Boolean

Значение True для перезаписи существующих файлов; в противном случае — значение False.True to overwrite existing files; otherwise False. Значение по умолчанию — False.Default is False.

onUserCancel
UICancelOption

Указывает, что должно выполняться, когда пользователь нажимает кнопки Отмена или Нет в диалоговом окне, если для параметра showUI задано значение True.Specifies behavior when the user clicks Cancel or No on the dialog box shown as a result of showUI set to True. Значение по умолчанию — ThrowException.Default is ThrowException.

Исключения

destinationFileName заканчивается косой чертой.destinationFileName ends with a trailing slash.

Для overwrite установлено значение False, а конечный файл уже существует.overwrite is set to False and the destination file already exists.

Сервер не отвечает в пределах указанного connectionTimeout.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.

Примеры

В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется C:\Documents and Settings\All Users\Documentsв.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")

Этот пример скачивает файл WineList.txt из http://www.cohowinery.com/downloads и сохраняет его в C:\Documents and Settings\All Users\Documents, указывая интервал времени ожидания 500 миллисекунд.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)

Комментарии

Если showUI параметр имеет Trueзначение, то отображается диалоговое окно, показывающее ход выполнения операции; диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции.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.

Если сервер не отвечает в течение указанного connectionTimeout, операция отменяется и создается исключение.If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFileвыводит сведения о трассировке при включении трассировки сети в приложении.DownloadFile outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе Включение трассировки сети.For more information, see Enabling Network Tracing.

Примечание

DownloadFile Метод не отправляет дополнительные заголовки HTTP.The DownloadFile method does not send optional HTTP headers. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если отсутствует заголовок необязательного агента пользователя.Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. Для отправки необязательных заголовков необходимо создать запрос с WebClient помощью класса.To send optional headers, you must construct a request using the WebClient class.

Примечание

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.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

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: AllWindows.Associated enumeration: AllWindows.

WebPermission
Управляет правами доступа к интернет-ресурсам HTTP.Controls rights to access HTTP Internet resources. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

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)

Параметры

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 для отображения хода выполнения операции; в противном случае — значение False.True to display the progress of the operation; otherwise False. Значение по умолчанию — False.Default is False.

connectionTimeout
Int32

Интервал ожидания в миллисекундах.Timeout interval, in milliseconds. Значение по умолчанию — 100 секунд.Default is 100 seconds.

overwrite
Boolean

Значение True для перезаписи существующих файлов; в противном случае — значение False.True to overwrite existing files; otherwise False. Значение по умолчанию — False.Default is False.

Исключения

destinationFileName заканчивается косой чертой.destinationFileName ends with a trailing slash.

Для overwrite установлено значение False, а конечный файл уже существует.overwrite is set to False and the destination file already exists.

Сервер не отвечает в пределах указанного connectionTimeout.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.

Примеры

В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется C:\Documents and Settings\All Users\Documentsв.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")

Этот пример скачивает файл WineList.txt из http://www.cohowinery.com/downloads и сохраняет его в C:\Documents and Settings\All Users\Documents, указывая интервал времени ожидания 500 миллисекунд.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)

Комментарии

Если showUI параметр имеет Trueзначение, то отображается диалоговое окно, показывающее ход выполнения операции; диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции.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.

Если сервер не отвечает в течение указанного connectionTimeout, операция отменяется и создается исключение.If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFileвыводит сведения о трассировке при включении трассировки сети в приложении.DownloadFile outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе Включение трассировки сети.For more information, see Enabling Network Tracing.

Примечание

DownloadFile Метод не отправляет дополнительные заголовки HTTP.The DownloadFile method does not send optional HTTP headers. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если отсутствует заголовок необязательного агента пользователя.Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. Для отправки необязательных заголовков необходимо создать запрос с WebClient помощью класса.To send optional headers, you must construct a request using the WebClient class.

Примечание

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.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

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: AllWindows.Associated enumeration: AllWindows.

WebPermission
Управляет правами доступа к интернет-ресурсам HTTP.Controls rights to access HTTP Internet resources. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

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)

Параметры

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 для отображения хода выполнения операции; в противном случае — значение False.True to display the progress of the operation; otherwise False. Значение по умолчанию — False.Default is False.

connectionTimeout
Int32

Интервал ожидания в миллисекундах.Timeout interval, in milliseconds. Значение по умолчанию — 100 секунд.Default is 100 seconds.

overwrite
Boolean

Значение True для перезаписи существующих файлов; в противном случае — значение False.True to overwrite existing files; otherwise False. Значение по умолчанию — False.Default is False.

onUserCancel
UICancelOption

Указывает, что должно выполняться, когда пользователь нажимает кнопки Отмена или Нет в диалоговом окне, если для параметра ShowUI задано значение True.Specifies behavior when the user clicks Cancel or No on the dialog box shown as a result of ShowUI set to True. Значение по умолчанию — ThrowException.Default is ThrowException.

Исключения

destinationFileName заканчивается косой чертой.destinationFileName ends with a trailing slash.

Для overwrite установлено значение False, а конечный файл уже существует.overwrite is set to False and the destination file already exists.

Сервер не отвечает в пределах указанного connectionTimeout.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.

Примеры

В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется C:\Documents and Settings\All Users\Documentsв.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")

Этот пример скачивает файл WineList.txt из http://www.cohowinery.com/downloads и сохраняет его в C:\Documents and Settings\All Users\Documents, указывая интервал времени ожидания 500 миллисекунд.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)

Комментарии

Если showUI параметр имеет Trueзначение, то отображается диалоговое окно, показывающее ход выполнения операции; диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции.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.

Если сервер не отвечает в течение указанного connectionTimeout, операция отменяется и создается исключение.If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFileвыводит сведения о трассировке при включении трассировки сети в приложении.DownloadFile outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе Включение трассировки сети.For more information, see Enabling Network Tracing.

Примечание

DownloadFile Метод не отправляет дополнительные заголовки HTTP.The DownloadFile method does not send optional HTTP headers. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если отсутствует заголовок необязательного агента пользователя.Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. Для отправки необязательных заголовков необходимо создать запрос с WebClient помощью класса.To send optional headers, you must construct a request using the WebClient class.

Примечание

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.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

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: AllWindows.Associated enumeration: AllWindows.

WebPermission
Управляет правами доступа к интернет-ресурсам HTTP.Controls rights to access HTTP Internet resources. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

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)

Параметры

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 для отображения хода выполнения операции; в противном случае — значение False.True to display the progress of the operation; otherwise False. Значение по умолчанию — False.Default is False.

connectionTimeout
Int32

Интервал ожидания в миллисекундах.Timeout interval, in milliseconds. Значение по умолчанию — 100 секунд.Default is 100 seconds.

overwrite
Boolean

Значение True для перезаписи существующих файлов; в противном случае — значение False.True to overwrite existing files; otherwise False. Значение по умолчанию — False.Default is False.

onUserCancel
UICancelOption

Указывает, что должно выполняться, когда пользователь нажимает кнопки Отмена или Нет в диалоговом окне, если для параметра ShowUI задано значение True.Specifies behavior when the user clicks Cancel or No on the dialog box shown as a result of ShowUI set to True. Значение по умолчанию — ThrowException.Default is ThrowException.

Исключения

destinationFileName заканчивается косой чертой.destinationFileName ends with a trailing slash.

Для overwrite установлено значение False, а конечный файл уже существует.overwrite is set to False and the destination file already exists.

Сервер не отвечает в пределах указанного connectionTimeout.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.

Примеры

В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется C:\Documents and Settings\All Users\Documentsв.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")

Этот пример скачивает файл WineList.txt из http://www.cohowinery.com/downloads и сохраняет его в C:\Documents and Settings\All Users\Documents, указывая интервал времени ожидания 500 миллисекунд.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)

Комментарии

Если showUI параметр имеет Trueзначение, то отображается диалоговое окно, показывающее ход выполнения операции; диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции.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.

Если сервер не отвечает в течение указанного connectionTimeout, операция отменяется и создается исключение.If the server does not respond within the specified connectionTimeout, the operation is cancelled, and an exception is thrown.

DownloadFileвыводит сведения о трассировке при включении трассировки сети в приложении.DownloadFile outputs trace information when you enable network tracing in your application. Дополнительные сведения см. в разделе Включение трассировки сети.For more information, see Enabling Network Tracing.

Примечание

DownloadFile Метод не отправляет дополнительные заголовки HTTP.The DownloadFile method does not send optional HTTP headers. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если отсутствует заголовок необязательного агента пользователя.Some servers may return 500 (Internal Server Error) if the optional user agent header is missing. Для отправки необязательных заголовков необходимо создать запрос с WebClient помощью класса.To send optional headers, you must construct a request using the WebClient class.

Примечание

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.The FTP protocol sends information, including passwords, in plain text and should not be used for transmitting sensitive information.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.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

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: AllWindows.Associated enumeration: AllWindows.

WebPermission
Управляет правами доступа к интернет-ресурсам HTTP.Controls rights to access HTTP Internet resources. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

Применяется к