Network.DownloadFile Метод

Определение

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

Microsoft.VisualBasic.Devices

Сборка:

Microsoft.VisualBasic.Forms.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")

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

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

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

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

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

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

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

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

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

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