Поделиться через


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 -> unit
Public 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 метод .

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

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

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

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

Имя загружаемого файла и путь к нему.

Исключения

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 метод .

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

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

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

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

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

Исключения

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 метод .

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

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

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

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

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

Исключения

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 метод .

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

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

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

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.

Исключения

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 метод .

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

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

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

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.

Исключения

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 метод .

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

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

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

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.

Исключения

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 метод .

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

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

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

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.

Исключения

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 метод .

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

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

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

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.

Исключения

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 метод .

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

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

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

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.

Исключения

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 метод .

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

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

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