Cómo: Descargar un archivo en Visual Basic

Artículo
10/07/2008

Actualización: noviembre 2007

My.Computer.Network.DownloadFile (Método) se puede utilizar para descargar un archivo remoto y almacenarlo en una ubicación concreta. Si el parámetro ShowUI se establece en True, aparece un cuadro de diálogo que muestra el progreso de la descarga y permite a los usuarios cancelar la operación. De manera predeterminada, no se sobrescriben los archivos existentes que tienen el mismo nombre; si desea sobrescribir los archivos existentes, establezca el parámetro overwrite en True.

Las condiciones siguientes pueden producir una excepción:

El nombre de la unidad no es válido (ArgumentException).
No se ha proporcionado la autenticación necesaria (UnauthorizedAccessException o SecurityException).
El servidor no responde dentro del valor de connectionTimeout especificado (TimeoutException).
El sitio Web deniega la solicitud (WebException).

Nota:
Las opciones disponibles en los cuadros de diálogo, y los nombres y las ubicaciones de los comandos de menú que se ven podrían diferir de lo que se describe en la Ayuda, en función de los valores de configuración o de edición activos. Esta página de Ayuda se ha redactado teniendo en cuenta la Configuración general de desarrollo. Para cambiar la configuración, elija la opción Importar y exportar configuraciones en el menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.

Las opciones disponibles en los cuadros de diálogo, y los nombres y las ubicaciones de los comandos de menú que se ven podrían diferir de lo que se describe en la Ayuda, en función de los valores de configuración o de edición activos. Esta página de Ayuda se ha redactado teniendo en cuenta la Configuración general de desarrollo. Para cambiar la configuración, elija la opción Importar y exportar configuraciones en el menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.

Nota de seguridad:
No tome ninguna decisión sobre el contenido del archivo basándose en su nombre. Por ejemplo, es posible que el archivo Form1.vb no sea un archivo de código fuente de Visual Basic. Compruebe todas las entradas antes de utilizar los datos en la aplicación. Puede que el contenido del archivo no sea el esperado y que los métodos que leen el archivo produzcan un error.

Para descargar un archivo

Utilice el método DownloadFile para descargar el archivo; especifique la ubicación del archivo de destino como una cadena o un identificador uniforme de recursos (URI) y la ubicación donde se va a almacenar el archivo. En este ejemplo se descarga el archivo WineList.txt desde http://www.cohowinery.com/downloads y se guarda en C:\Documents and Settings\All Users\Documents:
```
My.Computer.Network.DownloadFile _
    ("http://www.cohowinery.com/downloads/WineList.txt", _
    "C:\Documents and Settings\All Users\Documents\WineList.txt")
```

Para descargar un archivo, especificando un intervalo de tiempo de espera

Utilice el método DownloadFile para descargar el archivo; especifique la ubicación del archivo de destino como una cadena o un identificador uniforme de recursos (URI), la ubicación donde se va a almacenar el archivo y el intervalo de tiempo de espera en milisegundos (el valor predeterminado es 1000). Este ejemplo descarga el archivo WineList.txt de http://www.cohowinery.com/downloads y lo guarda en C:\Documents and Settings\All Users\Documents, especificando un intervalo de tiempo de espera de 500 milisegundos:
```
My.Computer.Network.DownloadFile _
    ("http://www.cohowinery.com/downloads/WineList.txt", _
    "C:\Documents and Settings\All Users\Documents\WineList.txt", False, 500)
```

Para descargar un archivo, proporcionando un nombre de usuario y contraseña

Utilice el método DownLoadFile para descargar el archivo; especifique la ubicación del archivo de destino como una cadena o un identificador uniforme de recursos (URI), la ubicación donde se va a almacenar el archivo, el nombre de usuario y la contraseña. Este ejemplo descarga el archivo WineList.txt de http://www.cohowinery.com/downloads y lo guarda en C:\Documents and Settings\All Users\Documents, con el nombre de usuario anonymous y una contraseña en blanco.

My.Computer.Network.DownloadFile _
    ("http://www.cohowinery.com/downloads/WineList.txt", _
    "C:\Documents and Settings\All Users\Documents\WineList.txt", "anonymous", "")

Nota de seguridad:
El método DownLoadFile utiliza el protocolo FTP para enviar información, incluidas las contraseñas, en texto sin formato y no se debe utilizar para transmitir información confidencial.