Network.DownloadFile Метод

Определение

Пространство имен:

Microsoft.VisualBasic.Devices

Сборка:

Microsoft.VisualBasic.dll

Загружает указанный удаленный файл и сохраняет его в указанном расположении.

Перегрузки

Имя	Описание
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 -> unit

Public Sub DownloadFile (address As String, destinationFileName As String)

Параметры

address

String

Путь к скачиванию файла, включая имя файла и адрес узла.

destinationFileName

String

Имя файла и путь к скачанного файла.

Исключения

ArgumentException

destinationFileName заканчивается косой чертой.

TimeoutException

Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).

SecurityException

У пользователя отсутствуют необходимые разрешения для выполнения сетевой операции.

WebException

Запрос отклоняется целевым веб-сервером.

Примеры

В этом примере файл 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")

В этом примере файл загружается из http://www.cohowinery.com/downloads файла WineList.txt и сохраняется в 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 выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Включение трассировки сети".

Note

Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если необязательный заголовок агента пользователя отсутствует. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.

Кому	Смотри
Скачивание файла	Практическое руководство. Скачивание файла

См. также раздел

• Uri
• ICredentials
• Объекты (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in 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 -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String)

Параметры

address

Uri

Путь к скачиванию файла, включая имя файла и адрес узла.

destinationFileName

String

Имя файла и путь к скачанного файла.

Исключения

ArgumentException

destinationFileName заканчивается косой чертой.

TimeoutException

Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).

SecurityException

У пользователя отсутствуют необходимые разрешения для выполнения сетевой операции.

WebException

Запрос отклоняется целевым веб-сервером.

Примеры

В этом примере файл 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")

В этом примере файл загружается из http://www.cohowinery.com/downloads файла WineList.txt и сохраняется в 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 выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Включение трассировки сети".

Note

Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если необязательный заголовок агента пользователя отсутствует. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.

Кому	Смотри
Скачивание файла	Практическое руководство. Скачивание файла

См. также раздел

• Uri
• ICredentials
• Объекты (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in 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 -> unit

Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String)

Параметры

address

String

Путь к скачиванию файла, включая имя файла и адрес узла.

destinationFileName

String

Имя файла и путь к скачанного файла.

userName

String

Имя пользователя для проверки подлинности. По умолчанию используется пустая строка "".

password

String

Пароль для проверки подлинности. По умолчанию используется пустая строка "".

Исключения

ArgumentException

destinationFileName заканчивается косой чертой.

TimeoutException

Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).

SecurityException

У пользователя отсутствуют необходимые разрешения для выполнения сетевой операции.

WebException

Запрос отклоняется целевым веб-сервером.

Примеры

В этом примере файл 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")

В этом примере файл загружается из http://www.cohowinery.com/downloads файла WineList.txt и сохраняется в 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 выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Включение трассировки сети".

Note

Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если необязательный заголовок агента пользователя отсутствует. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса.

Note

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.

Кому	Смотри
Скачивание файла	Практическое руководство. Скачивание файла

См. также раздел

• Uri
• ICredentials
• Объекты (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in 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 -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String)

Параметры

address

Uri

Путь к скачиванию файла, включая имя файла и адрес узла.

destinationFileName

String

Имя файла и путь к скачанного файла.

userName

String

Имя пользователя для проверки подлинности. По умолчанию используется пустая строка "".

password

String

Пароль для проверки подлинности. По умолчанию используется пустая строка "".

Исключения

ArgumentException

destinationFileName заканчивается косой чертой.

TimeoutException

Сервер не отвечает в течение времени ожидания по умолчанию (100 секунд).

SecurityException

У пользователя отсутствуют необходимые разрешения для выполнения сетевой операции.

WebException

Запрос отклоняется целевым веб-сервером.

Примеры

В этом примере файл 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")

В этом примере файл загружается из http://www.cohowinery.com/downloads файла WineList.txt и сохраняется в 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 выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Включение трассировки сети".

Note

Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если необязательный заголовок агента пользователя отсутствует. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса.

Note

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.

Кому	Смотри
Скачивание файла	Практическое руководство. Скачивание файла

См. также раздел

• Uri
• ICredentials
• Объекты (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

Загружает указанный удаленный файл и сохраняет его в указанном расположении.

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. Путь к скачиванию файла, включая имя файла и адрес узла.

destinationFileName

String

String. Имя файла и путь к скачанного файла.

networkCredentials

ICredentials

ICredentials. Предоставленные учетные данные.

showUI

Boolean

True для отображения хода выполнения операции; в противном случае False. По умолчанию — False.

connectionTimeout

Int32

Интервал времени ожидания в миллисекундах. Значение по умолчанию — 100 секунд.

overwrite

Boolean

True для перезаписи существующих файлов; в противном случае False. По умолчанию — False.

Исключения

ArgumentException

destinationFileName заканчивается косой чертой.

IOException

overwrite задано значение False и целевой файл уже существует.

TimeoutException

Сервер не отвечает в пределах указанного параметра connectionTimeout.

SecurityException

У пользователя отсутствуют необходимые разрешения для выполнения сетевой операции.

WebException

Запрос отклоняется целевым веб-сервером.

Примеры

В этом примере файл 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")

В этом примере файл загружается из http://www.cohowinery.com/downloads файла WineList.txt и сохраняется в 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 выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Включение трассировки сети".

Note

Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если необязательный заголовок агента пользователя отсутствует. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса.

Note

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.

Кому	Смотри
Скачивание файла	Практическое руководство. Скачивание файла

См. также раздел

• Uri
• ICredentials
• Объекты (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

Загружает указанный удаленный файл и сохраняет его в указанном расположении.

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

Путь к скачиванию файла, включая имя файла и адрес узла.

destinationFileName

String

Имя файла и путь к скачанного файла.

userName

String

Имя пользователя для проверки подлинности. По умолчанию используется пустая строка "".

password

String

Пароль для проверки подлинности. По умолчанию используется пустая строка "".

showUI

Boolean

True для отображения хода выполнения операции; в противном случае False. По умолчанию — False.

connectionTimeout

Int32

Int32. Интервал времени ожидания в миллисекундах. Значение по умолчанию — 100 секунд.

overwrite

Boolean

True для перезаписи существующих файлов; в противном случае False. По умолчанию — False.

Исключения

ArgumentException

destinationFileName заканчивается косой чертой.

IOException

overwrite задано значение False и целевой файл уже существует.

TimeoutException

Сервер не отвечает в пределах указанного параметра connectionTimeout.

SecurityException

У пользователя отсутствуют необходимые разрешения для выполнения сетевой операции.

WebException

Запрос отклоняется целевым веб-сервером.

Примеры

В этом примере файл 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")

В этом примере файл загружается из http://www.cohowinery.com/downloads файла WineList.txt и сохраняется в 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 выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Включение трассировки сети".

Note

Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если необязательный заголовок агента пользователя отсутствует. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса.

Note

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.

Кому	Смотри
Скачивание файла	Практическое руководство. Скачивание файла

См. также раздел

• Uri
• ICredentials
• Объекты (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

Загружает указанный удаленный файл и сохраняет его в указанном расположении.

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

Путь к скачиванию файла, включая имя файла и адрес узла.

destinationFileName

String

Имя файла и путь к скачанного файла.

networkCredentials

ICredentials

Предоставленные учетные данные.

showUI

Boolean

True для отображения хода выполнения операции; в противном случае False. По умолчанию — False.

connectionTimeout

Int32

Интервал времени ожидания в миллисекундах. Значение по умолчанию — 100 секунд.

overwrite

Boolean

True для перезаписи существующих файлов; в противном случае False. По умолчанию — False.

onUserCancel

UICancelOption

Указывает поведение, когда пользователь нажимает кнопку "Отмена" или "Нет " в диалоговом окне, отображаемом в результате showUI задания True. По умолчанию — ThrowException.

Исключения

ArgumentException

destinationFileName заканчивается косой чертой.

IOException

overwrite задано значение False и целевой файл уже существует.

TimeoutException

Сервер не отвечает в пределах указанного параметра connectionTimeout.

SecurityException

У пользователя отсутствуют необходимые разрешения для выполнения сетевой операции.

WebException

Запрос отклоняется целевым веб-сервером.

Примеры

В этом примере файл 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")

В этом примере файл загружается из http://www.cohowinery.com/downloads файла WineList.txt и сохраняется в 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 выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Включение трассировки сети".

Note

Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если необязательный заголовок агента пользователя отсутствует. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса.

Note

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.

Кому	Смотри
Скачивание файла	Практическое руководство. Скачивание файла

См. также раздел

• Uri
• ICredentials
• Объекты (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

Загружает указанный удаленный файл и сохраняет его в указанном расположении.

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

Путь к скачиванию файла, включая имя файла и адрес узла.

destinationFileName

String

Имя файла и путь к скачанного файла.

userName

String

Имя пользователя для проверки подлинности. По умолчанию используется пустая строка "".

password

String

Пароль для проверки подлинности. По умолчанию используется пустая строка "".

showUI

Boolean

True для отображения хода выполнения операции; в противном случае False. По умолчанию — False.

connectionTimeout

Int32

Интервал времени ожидания в миллисекундах. Значение по умолчанию — 100 секунд.

overwrite

Boolean

True для перезаписи существующих файлов; в противном случае False. По умолчанию — False.

Исключения

ArgumentException

destinationFileName заканчивается косой чертой.

IOException

overwrite задано значение False и целевой файл уже существует.

TimeoutException

Сервер не отвечает в пределах указанного параметра connectionTimeout.

SecurityException

У пользователя отсутствуют необходимые разрешения для выполнения сетевой операции.

WebException

Запрос отклоняется целевым веб-сервером.

Примеры

В этом примере файл 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")

В этом примере файл загружается из http://www.cohowinery.com/downloads файла WineList.txt и сохраняется в 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 выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Включение трассировки сети".

Note

Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если необязательный заголовок агента пользователя отсутствует. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса.

Note

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.

Кому	Смотри
Скачивание файла	Практическое руководство. Скачивание файла

См. также раздел

• Uri
• ICredentials
• Объекты (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

Загружает указанный удаленный файл и сохраняет его в указанном расположении.

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

Путь к скачиванию файла, включая имя файла и адрес узла.

destinationFileName

String

Имя файла и путь к скачанного файла.

userName

String

Имя пользователя для проверки подлинности. По умолчанию используется пустая строка "".

password

String

Пароль для проверки подлинности. По умолчанию используется пустая строка "".

showUI

Boolean

True для отображения хода выполнения операции; в противном случае False. По умолчанию — False.

connectionTimeout

Int32

Интервал времени ожидания в миллисекундах. Значение по умолчанию — 100 секунд.

overwrite

Boolean

True для перезаписи существующих файлов; в противном случае False. По умолчанию — False.

onUserCancel

UICancelOption

Указывает поведение, когда пользователь нажимает кнопку "Отмена" или "Нет " в диалоговом окне, отображаемом в результате ShowUI задания True. По умолчанию — ThrowException.

Исключения

ArgumentException

destinationFileName заканчивается косой чертой.

IOException

overwrite задано значение False и целевой файл уже существует.

TimeoutException

Сервер не отвечает в пределах указанного параметра connectionTimeout.

SecurityException

У пользователя отсутствуют необходимые разрешения для выполнения сетевой операции.

WebException

Запрос отклоняется целевым веб-сервером.

Примеры

В этом примере файл 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")

В этом примере файл загружается из http://www.cohowinery.com/downloads файла WineList.txt и сохраняется в 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 выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Включение трассировки сети".

Note

Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если необязательный заголовок агента пользователя отсутствует. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса.

Note

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.

Кому	Смотри
Скачивание файла	Практическое руководство. Скачивание файла

См. также раздел

• Uri
• ICredentials
• Объекты (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic

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

Загружает указанный удаленный файл и сохраняет его в указанном расположении.

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

Путь к скачиванию файла, включая имя файла и адрес узла.

destinationFileName

String

Имя файла и путь к скачанного файла.

userName

String

Имя пользователя для проверки подлинности. По умолчанию используется пустая строка "".

password

String

Пароль для проверки подлинности. По умолчанию используется пустая строка "".

showUI

Boolean

True для отображения хода выполнения операции; в противном случае False. По умолчанию — False.

connectionTimeout

Int32

Интервал времени ожидания в миллисекундах. Значение по умолчанию — 100 секунд.

overwrite

Boolean

True для перезаписи существующих файлов; в противном случае False. По умолчанию — False.

onUserCancel

UICancelOption

Указывает поведение, когда пользователь нажимает кнопку "Отмена" или "Нет " в диалоговом окне, отображаемом в результате ShowUI задания True. По умолчанию — ThrowException.

Исключения

ArgumentException

destinationFileName заканчивается косой чертой.

IOException

overwrite задано значение False и целевой файл уже существует.

TimeoutException

Сервер не отвечает в пределах указанного параметра connectionTimeout.

SecurityException

У пользователя отсутствуют необходимые разрешения для выполнения сетевой операции.

WebException

Запрос отклоняется целевым веб-сервером.

Примеры

В этом примере файл 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")

В этом примере файл загружается из http://www.cohowinery.com/downloads файла WineList.txt и сохраняется в 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 выводит сведения трассировки при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Включение трассировки сети".

Note

Метод DownloadFile не отправляет необязательные заголовки HTTP. Некоторые серверы могут возвращать 500 (внутренняя ошибка сервера), если необязательный заголовок агента пользователя отсутствует. Чтобы отправить необязательные заголовки, необходимо создать запрос с помощью WebClient класса.

Note

Протокол FTP отправляет сведения, включая пароли, в виде обычного текста и не должен использоваться для передачи конфиденциальной информации.

В следующей таблице приведен пример задачи, включающей My.Computer.Network.DownloadFile метод.

Кому	Смотри
Скачивание файла	Практическое руководство. Скачивание файла

См. также раздел

• Uri
• ICredentials
• Объекты (Visual Basic)
• How to: Download a File in Visual Basic
• How to: Parse File Paths in Visual Basic