Network.DownloadFile Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Загружает указанный удаленный файл и сохраняет его в указанном местоположении.
Перегрузки
| DownloadFile(String, String) |
Загружает указанный удаленный файл и сохраняет его в указанном местоположении. |
| DownloadFile(Uri, String) |
Загружает указанный удаленный файл и сохраняет его в указанном местоположении. |
| DownloadFile(String, String, String, String) |
Загружает указанный удаленный файл и сохраняет его в указанном местоположении. |
| DownloadFile(Uri, String, String, String) |
Загружает указанный удаленный файл и сохраняет его в указанном местоположении. |
| DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean) |
Загружает указанный удаленный файл и сохраняет его в указанном местоположении. |
| DownloadFile(String, String, String, String, Boolean, Int32, Boolean) |
Загружает указанный удаленный файл и сохраняет его в указанном местоположении. |
| DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption) |
Загружает указанный удаленный файл и сохраняет его в указанном местоположении. |
| DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean) |
Загружает указанный удаленный файл и сохраняет его в указанном местоположении. |
| DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption) |
Загружает указанный удаленный файл и сохраняет его в указанном местоположении. |
| DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption) |
Загружает указанный удаленный файл и сохраняет его в указанном местоположении. |
DownloadFile(String, String)
Загружает указанный удаленный файл и сохраняет его в указанном местоположении.
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName);public void DownloadFile (string address, string destinationFileName);member this.DownloadFile : string * string -> unitPublic Sub DownloadFile (address As String, destinationFileName As String)Параметры
- address
- String
Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.
- destinationFileName
- String
Имя загружаемого файла и путь к нему.
Исключения
destinationFileName заканчивается косой чертой.
Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).
Пользователь не имеет необходимых разрешений для выполнения сетевой операции.
Запрос отклонен целевым веб-сервером.
Примеры
В этом примере файл WineList.txt скачивается из http://www.cohowinery.com/downloads и сохраняется в 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.txthttp://www.cohowinery.com/downloads скачивается и сохраняется C:\Documents and Settings\All Users\Documentsв , задав интервал времени ожидания в 500 миллисекунд.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Комментарии
Если целевой файл уже существует, DownloadFile метод не перезапишет существующий файл. Можно использовать одну из других перегрузок DownloadFile метода, чтобы указать ему перезаписать существующие файлы, предоставить учетные данные пользователя или указать определенное значение времени ожидания.
DownloadFile выводит данные трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Включение трассировки сети.
Примечание
Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать значение 500 (внутренняя ошибка сервера), если отсутствует дополнительный заголовок агента пользователя. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса .
В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод .
| Кому | См. |
|---|---|
| скачать файл; | Практическое руководство. Скачивание файла |
См. также раздел
- Uri
- ICredentials
- Объекты (Visual Basic)
- Практическое руководство. Загрузка файла в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
DownloadFile(Uri, String)
Загружает указанный удаленный файл и сохраняет его в указанном местоположении.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName);public void DownloadFile (Uri address, string destinationFileName);member this.DownloadFile : Uri * string -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String)Параметры
- address
- Uri
Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.
- destinationFileName
- String
Имя загружаемого файла и путь к нему.
Исключения
destinationFileName заканчивается косой чертой.
Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).
Пользователь не имеет необходимых разрешений для выполнения сетевой операции.
Запрос отклонен целевым веб-сервером.
Примеры
В этом примере файл WineList.txt скачивается из http://www.cohowinery.com/downloads и сохраняется в 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.txthttp://www.cohowinery.com/downloads скачивается и сохраняется C:\Documents and Settings\All Users\Documentsв , задав интервал времени ожидания в 500 миллисекунд.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Комментарии
Если целевой файл уже существует, DownloadFile метод не перезапишет существующий файл. Можно использовать одну из других перегрузок DownloadFile метода, чтобы указать ему перезаписать существующие файлы, предоставить учетные данные пользователя или указать определенное значение времени ожидания. DownloadFile выводит данные трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Включение трассировки сети.
Примечание
Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать значение 500 (внутренняя ошибка сервера), если отсутствует дополнительный заголовок агента пользователя. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса .
В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод .
| Кому | См. |
|---|---|
| скачать файл; | Практическое руководство. Скачивание файла |
См. также раздел
- Uri
- ICredentials
- Объекты (Visual Basic)
- Практическое руководство. Загрузка файла в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
DownloadFile(String, String, String, String)
Загружает указанный удаленный файл и сохраняет его в указанном местоположении.
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);public void DownloadFile (string address, string destinationFileName, string userName, string password);member this.DownloadFile : string * string * string * string -> unitPublic Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String)Параметры
- address
- String
Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.
- destinationFileName
- String
Имя загружаемого файла и путь к нему.
- userName
- String
Имя пользователя, подлинность которого необходимо проверить. Значением по умолчанию является пустая строка, "".
- password
- String
Пароль для проверки подлинности. Значением по умолчанию является пустая строка, "".
Исключения
destinationFileName заканчивается косой чертой.
Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).
Пользователь не имеет необходимых разрешений для выполнения сетевой операции.
Запрос отклонен целевым веб-сервером.
Примеры
В этом примере файл WineList.txt скачивается из http://www.cohowinery.com/downloads и сохраняется в 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.txthttp://www.cohowinery.com/downloads скачивается и сохраняется C:\Documents and Settings\All Users\Documentsв , задав интервал времени ожидания в 500 миллисекунд.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Комментарии
Если целевой файл уже существует, DownloadFile метод не перезапишет существующий файл. Можно использовать одну из других перегрузок DownloadFile метода, чтобы указать ему перезаписать существующие файлы или указать определенное значение времени ожидания.
DownloadFile выводит данные трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Включение трассировки сети.
Примечание
Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать значение 500 (внутренняя ошибка сервера), если отсутствует дополнительный заголовок агента пользователя. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса .
Примечание
Протокол FTP отправляет информацию, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.
В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод .
| Кому | См. |
|---|---|
| скачать файл; | Практическое руководство. Скачивание файла |
См. также раздел
- Uri
- ICredentials
- Объекты (Visual Basic)
- Практическое руководство. Загрузка файла в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
DownloadFile(Uri, String, String, String)
Загружает указанный удаленный файл и сохраняет его в указанном местоположении.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);public void DownloadFile (Uri address, string destinationFileName, string userName, string password);member this.DownloadFile : Uri * string * string * string -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String)Параметры
- address
- Uri
Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.
- destinationFileName
- String
Имя загружаемого файла и путь к нему.
- userName
- String
Имя пользователя, подлинность которого необходимо проверить. Значением по умолчанию является пустая строка, "".
- password
- String
Пароль для проверки подлинности. Значением по умолчанию является пустая строка, "".
Исключения
destinationFileName заканчивается косой чертой.
Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).
Пользователь не имеет необходимых разрешений для выполнения сетевой операции.
Запрос отклонен целевым веб-сервером.
Примеры
В этом примере файл WineList.txt скачивается из http://www.cohowinery.com/downloads и сохраняется в 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.txthttp://www.cohowinery.com/downloads скачивается и сохраняется C:\Documents and Settings\All Users\Documentsв , задав интервал времени ожидания в 500 миллисекунд.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Комментарии
Если целевой файл уже существует, DownloadFile метод не перезапишет существующий файл. Можно использовать одну из других перегрузок DownloadFile метода, чтобы указать ему перезаписать существующие файлы или указать определенное значение времени ожидания.
DownloadFile выводит данные трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Включение трассировки сети.
Примечание
Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать значение 500 (внутренняя ошибка сервера), если отсутствует дополнительный заголовок агента пользователя. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса .
Примечание
Протокол FTP отправляет информацию, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.
В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод .
| Кому | См. |
|---|---|
| скачать файл; | Практическое руководство. Скачивание файла |
См. также раздел
- Uri
- ICredentials
- Объекты (Visual Basic)
- Практическое руководство. Загрузка файла в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)
Загружает указанный удаленный файл и сохраняет его в указанном местоположении.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite);public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite);member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)Параметры
- address
- Uri
String или Uri. Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.
- destinationFileName
- String
String. Имя загружаемого файла и путь к нему.
- networkCredentials
- ICredentials
ICredentials. Учетные данные, которые необходимо предоставить.
- showUI
- Boolean
Значение True для отображения хода выполнения операции; в противном случае — значение False. Значение по умолчанию — False.
- connectionTimeout
- Int32
Интервал ожидания в миллисекундах. Значение по умолчанию — 100 секунд.
- overwrite
- Boolean
Значение True для перезаписи существующих файлов; в противном случае — значение False. Значение по умолчанию — False.
Исключения
destinationFileName заканчивается косой чертой.
Для overwrite установлено значение False, а конечный файл уже существует.
Сервер не отвечает в пределах указанного connectionTimeout.
Пользователь не имеет необходимых разрешений для выполнения сетевой операции.
Запрос отклонен целевым веб-сервером.
Примеры
В этом примере файл WineList.txt скачивается из http://www.cohowinery.com/downloads и сохраняется в 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.txthttp://www.cohowinery.com/downloads скачивается и сохраняется C:\Documents and Settings\All Users\Documentsв , задав интервал времени ожидания в 500 миллисекунд.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Комментарии
Если showUI для параметра задано значение True, появится диалоговое окно с отображением хода выполнения операции. Диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции. Диалоговое окно не является модальным и поэтому не блокирует ввод данных пользователем в другие окна программы.
Если сервер не отвечает в указанном connectionTimeoutобъекте , операция отменяется и возникает исключение.
DownloadFile выводит данные трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Включение трассировки сети.
Примечание
Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать значение 500 (внутренняя ошибка сервера), если отсутствует дополнительный заголовок агента пользователя. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса .
Примечание
Протокол FTP отправляет информацию, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.
В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод .
| Кому | См. |
|---|---|
| скачать файл; | Практическое руководство. Скачивание файла |
См. также раздел
- Uri
- ICredentials
- Объекты (Visual Basic)
- Практическое руководство. Загрузка файла в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)
Загружает указанный удаленный файл и сохраняет его в указанном местоположении.
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);member this.DownloadFile : string * string * string * string * bool * int * bool -> unitPublic Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)Параметры
- address
- String
Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.
- destinationFileName
- String
Имя загружаемого файла и путь к нему.
- userName
- String
Имя пользователя, подлинность которого необходимо проверить. Значением по умолчанию является пустая строка, "".
- password
- String
Пароль для проверки подлинности. Значением по умолчанию является пустая строка, "".
- showUI
- Boolean
Значение True для отображения хода выполнения операции; в противном случае — значение False. Значение по умолчанию — False.
- connectionTimeout
- Int32
Int32. Интервал ожидания в миллисекундах. Значение по умолчанию — 100 секунд.
- overwrite
- Boolean
Значение True для перезаписи существующих файлов; в противном случае — значение False. Значение по умолчанию — False.
Исключения
destinationFileName заканчивается косой чертой.
Для overwrite установлено значение False, а конечный файл уже существует.
Сервер не отвечает в пределах указанного connectionTimeout.
Пользователь не имеет необходимых разрешений для выполнения сетевой операции.
Запрос отклонен целевым веб-сервером.
Примеры
В этом примере файл WineList.txt скачивается из http://www.cohowinery.com/downloads и сохраняется в 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.txthttp://www.cohowinery.com/downloads скачивается и сохраняется C:\Documents and Settings\All Users\Documentsв , задав интервал времени ожидания в 500 миллисекунд.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Комментарии
Если showUI для параметра задано значение True, появится диалоговое окно с отображением хода выполнения операции. Диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции. Диалоговое окно не является модальным и поэтому не блокирует ввод данных пользователем в другие окна программы.
Если сервер не отвечает в указанном connectionTimeoutобъекте , операция отменяется и возникает исключение.
DownloadFile выводит данные трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Включение трассировки сети.
Примечание
Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать значение 500 (внутренняя ошибка сервера), если отсутствует дополнительный заголовок агента пользователя. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса .
Примечание
Протокол FTP отправляет информацию, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.
В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод .
| Кому | См. |
|---|---|
| скачать файл; | Практическое руководство. Скачивание файла |
См. также раздел
- Uri
- ICredentials
- Объекты (Visual Basic)
- Практическое руководство. Загрузка файла в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)
Загружает указанный удаленный файл и сохраняет его в указанном местоположении.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)Параметры
- address
- Uri
Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.
- destinationFileName
- String
Имя загружаемого файла и путь к нему.
- networkCredentials
- ICredentials
Учетные данные, которые необходимо предоставить.
- showUI
- Boolean
Значение True для отображения хода выполнения операции; в противном случае — значение False. Значение по умолчанию — False.
- connectionTimeout
- Int32
Интервал ожидания в миллисекундах. Значение по умолчанию — 100 секунд.
- overwrite
- Boolean
Значение True для перезаписи существующих файлов; в противном случае — значение False. Значение по умолчанию — False.
- onUserCancel
- UICancelOption
Указывает, что должно выполняться, когда пользователь нажимает кнопки Отмена или Нет в диалоговом окне, если для параметра showUI задано значение True. Значение по умолчанию — ThrowException.
Исключения
destinationFileName заканчивается косой чертой.
Для overwrite установлено значение False, а конечный файл уже существует.
Сервер не отвечает в пределах указанного connectionTimeout.
Пользователь не имеет необходимых разрешений для выполнения сетевой операции.
Запрос отклонен целевым веб-сервером.
Примеры
В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется в 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.txthttp://www.cohowinery.com/downloads скачивается и сохраняется C:\Documents and Settings\All Users\Documentsв , задав интервал времени ожидания 500 миллисекунд.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Комментарии
Если showUI для задано значение True, появляется диалоговое окно, показывающее ход выполнения операции; диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции. Диалоговое окно не является модальным и поэтому не блокирует ввод данных пользователем в другие окна в программе.
Если сервер не отвечает в указанном connectionTimeoutобъекте , операция отменяется и создается исключение.
DownloadFile выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Включение трассировки сети.
Примечание
Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать значение 500 (внутренняя ошибка сервера), если отсутствует дополнительный заголовок агента пользователя. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса .
Примечание
Протокол FTP отправляет информацию, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.
В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод .
| Кому | См. |
|---|---|
| скачать файл; | Практическое руководство. Скачивание файла |
См. также раздел
- Uri
- ICredentials
- Объекты (Visual Basic)
- Практическое руководство. Загрузка файла в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)
Загружает указанный удаленный файл и сохраняет его в указанном местоположении.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);member this.DownloadFile : Uri * string * string * string * bool * int * bool -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)Параметры
- address
- Uri
Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.
- destinationFileName
- String
Имя загружаемого файла и путь к нему.
- userName
- String
Имя пользователя, подлинность которого необходимо проверить. Значением по умолчанию является пустая строка, "".
- password
- String
Пароль для проверки подлинности. Значением по умолчанию является пустая строка, "".
- showUI
- Boolean
Значение True для отображения хода выполнения операции; в противном случае — значение False. Значение по умолчанию — False.
- connectionTimeout
- Int32
Интервал ожидания в миллисекундах. Значение по умолчанию — 100 секунд.
- overwrite
- Boolean
Значение True для перезаписи существующих файлов; в противном случае — значение False. Значение по умолчанию — False.
Исключения
destinationFileName заканчивается косой чертой.
Для overwrite установлено значение False, а конечный файл уже существует.
Сервер не отвечает в пределах указанного connectionTimeout.
Пользователь не имеет необходимых разрешений для выполнения сетевой операции.
Запрос отклонен целевым веб-сервером.
Примеры
В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется в 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.txthttp://www.cohowinery.com/downloads скачивается и сохраняется C:\Documents and Settings\All Users\Documentsв , задав интервал времени ожидания 500 миллисекунд.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Комментарии
Если showUI для задано значение True, появляется диалоговое окно, показывающее ход выполнения операции; диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции. Диалоговое окно не является модальным и поэтому не блокирует ввод данных пользователем в другие окна в программе.
Если сервер не отвечает в указанном connectionTimeoutобъекте , операция отменяется и создается исключение.
DownloadFile выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Включение трассировки сети.
Примечание
Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать значение 500 (внутренняя ошибка сервера), если отсутствует дополнительный заголовок агента пользователя. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса .
Примечание
Протокол FTP отправляет информацию, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.
В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод .
| Кому | См. |
|---|---|
| скачать файл; | Практическое руководство. Скачивание файла |
См. также раздел
- Uri
- ICredentials
- Объекты (Visual Basic)
- Практическое руководство. Загрузка файла в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)
Загружает указанный удаленный файл и сохраняет его в указанном местоположении.
public:
void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.DownloadFile : string * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)Параметры
- address
- String
Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.
- destinationFileName
- String
Имя загружаемого файла и путь к нему.
- userName
- String
Имя пользователя, подлинность которого необходимо проверить. Значением по умолчанию является пустая строка, "".
- password
- String
Пароль для проверки подлинности. Значением по умолчанию является пустая строка, "".
- showUI
- Boolean
Значение True для отображения хода выполнения операции; в противном случае — значение False. Значение по умолчанию — False.
- connectionTimeout
- Int32
Интервал ожидания в миллисекундах. Значение по умолчанию — 100 секунд.
- overwrite
- Boolean
Значение True для перезаписи существующих файлов; в противном случае — значение False. Значение по умолчанию — False.
- onUserCancel
- UICancelOption
Указывает, что должно выполняться, когда пользователь нажимает кнопки Отмена или Нет в диалоговом окне, если для параметра ShowUI задано значение True. Значение по умолчанию — ThrowException.
Исключения
destinationFileName заканчивается косой чертой.
Для overwrite установлено значение False, а конечный файл уже существует.
Сервер не отвечает в пределах указанного connectionTimeout.
Пользователь не имеет необходимых разрешений для выполнения сетевой операции.
Запрос отклонен целевым веб-сервером.
Примеры
В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется в 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.txthttp://www.cohowinery.com/downloads скачивается и сохраняется C:\Documents and Settings\All Users\Documentsв , задав интервал времени ожидания 500 миллисекунд.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Комментарии
Если showUI для задано значение True, появляется диалоговое окно, показывающее ход выполнения операции; диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции. Диалоговое окно не является модальным и поэтому не блокирует ввод данных пользователем в другие окна в программе.
Если сервер не отвечает в указанном connectionTimeoutобъекте , операция отменяется и создается исключение.
DownloadFile выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Включение трассировки сети.
Примечание
Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать значение 500 (внутренняя ошибка сервера), если отсутствует дополнительный заголовок агента пользователя. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса .
Примечание
Протокол FTP отправляет информацию, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.
В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод .
| Кому | См. |
|---|---|
| скачать файл; | Практическое руководство. Скачивание файла |
См. также раздел
- Uri
- ICredentials
- Объекты (Visual Basic)
- Практическое руководство. Загрузка файла в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)
Загружает указанный удаленный файл и сохраняет его в указанном местоположении.
public:
void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.DownloadFile : Uri * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)Параметры
- address
- Uri
Путь к файлу, который необходимо загрузить, включая имя файла и адрес сайта.
- destinationFileName
- String
Имя загружаемого файла и путь к нему.
- userName
- String
Имя пользователя, подлинность которого необходимо проверить. Значением по умолчанию является пустая строка, "".
- password
- String
Пароль для проверки подлинности. Значением по умолчанию является пустая строка, "".
- showUI
- Boolean
Значение True для отображения хода выполнения операции; в противном случае — значение False. Значение по умолчанию — False.
- connectionTimeout
- Int32
Интервал ожидания в миллисекундах. Значение по умолчанию — 100 секунд.
- overwrite
- Boolean
Значение True для перезаписи существующих файлов; в противном случае — значение False. Значение по умолчанию — False.
- onUserCancel
- UICancelOption
Указывает, что должно выполняться, когда пользователь нажимает кнопки Отмена или Нет в диалоговом окне, если для параметра ShowUI задано значение True. Значение по умолчанию — ThrowException.
Исключения
destinationFileName заканчивается косой чертой.
Для overwrite установлено значение False, а конечный файл уже существует.
Сервер не отвечает в пределах указанного connectionTimeout.
Пользователь не имеет необходимых разрешений для выполнения сетевой операции.
Запрос отклонен целевым веб-сервером.
Примеры
В этом примере файл WineList.txt загружается из http://www.cohowinery.com/downloads и сохраняется в 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.txthttp://www.cohowinery.com/downloads скачивается и сохраняется C:\Documents and Settings\All Users\Documentsв , задав интервал времени ожидания 500 миллисекунд.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Комментарии
Если showUI для задано значение True, появляется диалоговое окно, показывающее ход выполнения операции; диалоговое окно содержит кнопку Отмена , которую можно использовать для отмены операции. Диалоговое окно не является модальным и поэтому не блокирует ввод данных пользователем в другие окна в программе.
Если сервер не отвечает в указанном connectionTimeoutобъекте , операция отменяется и создается исключение.
DownloadFile выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Включение трассировки сети.
Примечание
Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать значение 500 (внутренняя ошибка сервера), если отсутствует дополнительный заголовок агента пользователя. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса .
Примечание
Протокол FTP отправляет информацию, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.
В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод .
| Кому | См. |
|---|---|
| скачать файл; | Практическое руководство. Скачивание файла |
См. также раздел
- Uri
- ICredentials
- Объекты (Visual Basic)
- Практическое руководство. Загрузка файла в Visual Basic
- Практическое руководство. Анализ путей к файлам в Visual Basic
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по