WebClient.DownloadFile Метод

Определение

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

System.Net

Сборки:

netstandard.dll, System.Net.WebClient.dll

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

Перегрузки

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

DownloadFile(Uri, String)

Исходный код:

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в качестве источника ресурса (URI), из которого необходимо скачать данные.

fileName

String

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

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр fileName имеет значение null.

WebException

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

-или-

fileName is null или Empty.

-или-

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

-или-

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

NotSupportedException

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

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

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

Загружает ресурс с указанным универсальным кодом ресурса (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

Параметр address имеет значение null.

WebException

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

-или-

fileName is 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))

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

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

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

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

Заметка

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

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