WebClient.DownloadFile Метод

Ссылка

Определение

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

Сборка:: System.Net.WebClient.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Загружает ресурс с указанным универсальным кодом ресурса (URI) в локальный файл.

Перегрузки

DownloadFile(Uri, String)	Загружает ресурс с указанным универсальным кодом ресурса (URI) в локальный файл.
DownloadFile(String, String)	Загружает ресурс с указанным универсальным кодом ресурса (URI) в локальный файл.

DownloadFile(Uri, String)

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Загружает ресурс с указанным универсальным кодом ресурса (URI) в локальный файл.

public:
 void DownloadFile(Uri ^ address, System::String ^ fileName);

public void DownloadFile (Uri address, string fileName);

member this.DownloadFile : Uri * string -> unit

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

Параметры

address: Uri

URI, указанный как String, из которого необходимо скачать данные.

fileName: String

Имя локального файла, который требуется получить данные.

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр fileNamenull.

WebException

URI, сформированный объединением BaseAddress и address, является недопустимым.

-или-

filename null или Empty.

-или-

Файл не существует.

-или-

Произошла ошибка при скачивании данных.

NotSupportedException

Метод вызывается одновременно на нескольких потоках.

Метод DownloadFile загружает данные локального файла из URI, указанного в параметре address. Этот метод блокирует скачивание ресурса. Чтобы скачать ресурс и продолжить выполнение во время ожидания ответа сервера, используйте один из методов DownloadFileAsync.

Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.

Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.

При использовании этого метода в приложении среднего уровня, например на странице ASP.NET, вы получите сообщение об ошибке, если учетная запись, в которой выполняется приложение, не имеет разрешения на доступ к файлу.

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

DownloadFile(String, String)

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Исходный код:: WebClient.cs

Загружает ресурс с указанным универсальным кодом ресурса (URI) в локальный файл.

public:
 void DownloadFile(System::String ^ address, System::String ^ fileName);

public void DownloadFile (string address, string fileName);

member this.DownloadFile : string * string -> unit

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

Параметры

address: String

Универсальный код ресурса (URI), из которого нужно скачать данные.

fileName: String

Имя локального файла, который требуется получить данные.

Исключения

ArgumentNullException

Параметр addressnull.

WebException

URI, сформированный объединением BaseAddress и address, является недопустимым.

-или-

filename null или Empty.

-или-

Файл не существует.

-или- Произошла ошибка при скачивании данных.

NotSupportedException

Метод вызывается одновременно на нескольких потоках.

Примеры

В следующем примере кода загружается файл из http://www.contoso.com на локальный жесткий диск.

String^ remoteUri = "http://www.contoso.com/library/homepage/images/";
String^ fileName = "ms-banner.gif", ^myStringWebResource = nullptr;
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Concatenate the domain with the Web resource filename.
myStringWebResource = String::Concat( remoteUri, fileName );
Console::WriteLine( "Downloading File \"{0}\" from \"{1}\" .......\n\n", fileName, myStringWebResource );
// Download the Web resource and save it into the current filesystem folder.
myWebClient->DownloadFile( myStringWebResource, fileName );
Console::WriteLine( "Successfully Downloaded File \"{0}\" from \"{1}\"", fileName, myStringWebResource );
Console::WriteLine( "\nDownloaded file saved in the following file system folder:\n\t {0}", Application::StartupPath );

string remoteUri = "http://www.contoso.com/library/homepage/images/";
string fileName = "ms-banner.gif", myStringWebResource = null;
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Concatenate the domain with the Web resource filename.
myStringWebResource = remoteUri + fileName;
Console.WriteLine("Downloading File \"{0}\" from \"{1}\" .......\n\n", fileName, myStringWebResource);
// Download the Web resource and save it into the current filesystem folder.
myWebClient.DownloadFile(myStringWebResource,fileName);		
Console.WriteLine("Successfully Downloaded File \"{0}\" from \"{1}\"", fileName, myStringWebResource);
Console.WriteLine("\nDownloaded file saved in the following file system folder:\n\t" + Application.StartupPath);

Dim remoteUri As String = "http://www.contoso.com/library/homepage/images/"
Dim fileName As String = "ms-banner.gif"
Dim myStringWebResource As String = Nothing
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Concatenate the domain with the Web resource filename. Because DownloadFile 
'requires a fully qualified resource name, concatenate the domain with the Web resource file name.
myStringWebResource = remoteUri + fileName
Console.WriteLine("Downloading File ""{0}"" from ""{1}"" ......." + ControlChars.Cr + ControlChars.Cr, fileName, myStringWebResource)
' The DownloadFile() method downloads the Web resource and saves it into the current file-system folder.
myWebClient.DownloadFile(myStringWebResource, fileName)
Console.WriteLine("Successfully Downloaded file ""{0}"" from ""{1}""", fileName, myStringWebResource)
Console.WriteLine((ControlChars.Cr + "Downloaded file saved in the following file system folder:" + ControlChars.Cr + ControlChars.Tab + Application.StartupPath))

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

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

WebClient.DownloadFile Метод

Определение

Перегрузки

DownloadFile(Uri, String)

Параметры

Исключения

Комментарии

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

DownloadFile(String, String)

Параметры

Исключения

Примеры

Комментарии

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

Дополнительные ресурсы