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)

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

Identificador URI especificado como String, desde el que se descargan los datos.

fileName
String

Nombre del archivo local que va a recibir los datos.

Excepciones

ArgumentNullException

El parámetro address es null.

o bien

El parámetro fileName es null.

WebException

El identificador URI formado al combinar BaseAddress y address no es válido.

o bien

filename es null o Empty.

o bien

El archivo no existe.

o bien

Se ha producido un error al descargar los datos.

NotSupportedException

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

Comentarios

El DownloadFile método descarga en los datos de un archivo local del URI especificado por en el address parámetro . 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 DownloadFileAsync métodos .

Si la BaseAddress propiedad 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 QueryString propiedad 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 cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red 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)

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

URI desde el que se descargan los datos.

fileName
String

Nombre del archivo local que va a recibir los datos.

Excepciones

ArgumentNullException

El parámetro address es null.

WebException

El identificador URI formado al combinar BaseAddress y address no es válido.

o bien

filename es null o Empty.

o bien

El archivo no existe.

O bien se ha producido un error al descargar los datos.

NotSupportedException

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

Ejemplos

En el ejemplo de código siguiente se descarga un archivo de http://www.contoso.com a la unidad de 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

El DownloadFile método descarga en los datos de un archivo local del URI especificado por en el address parámetro . 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 DownloadFileAsync métodos .

Si la BaseAddress propiedad 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 QueryString propiedad 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 cuando se habilita el seguimiento de red en la aplicación. Para obtener más información, consulte Seguimiento de red 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