Compartir a través de

WebClient.DownloadFile Método

  • Referencia

Definición

Espacio de nombres:
System.Net
Ensamblado:
System.Net.WebClient.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll

Descarga el recurso con el URI especificado en un archivo local.

Sobrecargas

DownloadFile(Uri, String)

Descarga el recurso con el URI especificado en un archivo local.
DownloadFile(String, String)

Descarga el recurso con el URI especificado en un archivo local.

DownloadFile(Uri, String)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Descarga el recurso con el URI especificado en un archivo local.

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)

Parámetros

address
Uri

El URI especificado como un String, desde el que se descargarán los datos.

fileName
String

Nombre del archivo local que va a recibir los datos.

Excepciones

ArgumentNullException

El parámetro address es null.

-o-

El parámetro fileName es null.

WebException

El URI formado mediante la combinación de BaseAddress y address no es válido.

-o-

filename es null o Empty.

-o-

El archivo no existe.

-o-

Error al descargar datos.

NotSupportedException

Se ha llamado al método simultáneamente en varios subprocesos.

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

El método DownloadFile descarga en los datos de un archivo local del URI especificado por en el parámetro address. Este método se bloquea al descargar el recurso. Para descargar un recurso y continuar ejecutándose mientras espera la respuesta del servidor, use uno de los métodos DownloadFileAsync.

Si la propiedad BaseAddress no es una cadena vacía ("") y address no contiene un URI absoluto, address debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto de los datos solicitados. Si la propiedad QueryString no es una cadena vacía, se anexa a address.

Este método usa el comando RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.

Nota

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte seguimiento de red de en .NET Framework.

Al usar este método en una aplicación de nivel intermedio, como una página de ASP.NET, recibirá un error si la cuenta con la que se ejecuta la aplicación no tiene permiso para acceder al archivo.

Se aplica a

DownloadFile(String, String)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Descarga el recurso con el URI especificado en un archivo local.

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)

Parámetros

address
String

Identificador URI desde el que se van a descargar los datos.

fileName
String

Nombre del archivo local que va a recibir los datos.

Excepciones

ArgumentNullException

El parámetro address es null.

WebException

El URI formado mediante la combinación de BaseAddress y address no es válido.

-o-

filename es null o Empty.

-o-

El archivo no existe.

-o bien- Error al descargar datos.

NotSupportedException

Se ha llamado al método simultáneamente en varios subprocesos.

Ejemplos

En el ejemplo de código siguiente se descarga un archivo de http://www.contoso.com al disco duro local.

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

Comentarios

Cautela

WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.

El método DownloadFile descarga en los datos de un archivo local del URI especificado por en el parámetro address. Este método se bloquea al descargar el recurso. Para descargar un recurso y continuar ejecutándose mientras espera la respuesta del servidor, use uno de los métodos DownloadFileAsync.

Si la propiedad BaseAddress no es una cadena vacía ("") y address no contiene un URI absoluto, address debe ser un URI relativo combinado con BaseAddress para formar el URI absoluto de los datos solicitados. Si la propiedad QueryString no es una cadena vacía, se anexa a address.

Este método usa el comando RETR para descargar un recurso FTP. Para un recurso HTTP, se usa el método GET.

Nota

Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte seguimiento de red de en .NET Framework.

Al usar este método en una aplicación de nivel intermedio, como una página de ASP.NET, recibirá un error si la cuenta con la que se ejecuta la aplicación no tiene permiso para acceder al archivo.

Se aplica a