WebClient.DownloadFile Метод

Определение

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

System.Net

Сборка:

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, с которого будут загружены данные.

fileName

String

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

Исключения

ArgumentNullException

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

-или-

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

WebException

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

-или-

filename имеет значение null или Empty.

-или-

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

-или-

При загрузке данных произошла ошибка.

NotSupportedException

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

Комментарии

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

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address который объединяется с 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 имеет значение 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))

Комментарии

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

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

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

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.

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