Network.DownloadFile Método

Referencia

Definición

Espacio de nombres:: Microsoft.VisualBasic.Devices

Ensamblado:: Microsoft.VisualBasic.dll

Ensamblado:: Microsoft.VisualBasic.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

Sobrecargas

DownloadFile(String, String)	Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.
DownloadFile(Uri, String)	Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.
DownloadFile(String, String, String, String)	Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.
DownloadFile(Uri, String, String, String)	Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)	Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)	Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)	Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)	Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

DownloadFile(String, String)

Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName);

public void DownloadFile (string address, string destinationFileName);

member this.DownloadFile : string * string -> unit

Public Sub DownloadFile (address As String, destinationFileName As String)

Parámetros

address: String

Ruta de acceso al archivo que se va a descargar, incluidos el nombre de archivo y la dirección del host.

destinationFileName: String

Nombre de archivo y ruta de acceso al archivo descargado.

Excepciones

ArgumentException

destinationFileName finaliza con una barra oblicua final.

TimeoutException

El servidor no responde dentro del tiempo de espera predeterminado (100 segundos).

SecurityException

Al usuario le faltan los permisos necesarios para realizar una operación de red.

WebException

La solicitud es denegado por el servidor web de destino.

Ejemplos

En este ejemplo se descarga el archivo WineList.txt de 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")

En este ejemplo se descarga el archivo WineList.txt de http://www.cohowinery.com/downloads y se C:\Documents and Settings\All Users\Documentsguarda en , especificando un intervalo de tiempo de espera de 500 milisegundos.

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

Comentarios

DownloadFile genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Habilitación del seguimiento de red.

Nota

El DownloadFile método no envía encabezados HTTP opcionales. Algunos servidores pueden devolver 500 (error interno del servidor) si falta el encabezado opcional del agente de usuario. Para enviar encabezados opcionales, debe construir una solicitud mediante la WebClient clase .

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.Network.DownloadFile método .

En	Vea
Descarga de un archivo	Procedimiento para descargar un archivo

Consulte también

Se aplica a

DownloadFile(Uri, String)

Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName);

public void DownloadFile (Uri address, string destinationFileName);

member this.DownloadFile : Uri * string -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String)

Parámetros

address: Uri

Ruta de acceso al archivo que se va a descargar, incluidos el nombre de archivo y la dirección del host.

destinationFileName: String

Nombre de archivo y ruta de acceso al archivo descargado.

Excepciones

ArgumentException

destinationFileName finaliza con una barra oblicua final.

TimeoutException

El servidor no responde dentro del tiempo de espera predeterminado (100 segundos).

SecurityException

Al usuario le faltan los permisos necesarios para realizar una operación de red.

WebException

La solicitud es denegado por el servidor web de destino.

Ejemplos

En este ejemplo se descarga el archivo WineList.txt de 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")

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

Comentarios

Si el archivo de destino ya existe, el DownloadFile método no sobrescribirá el archivo existente. Puede usar una de las otras sobrecargas del DownloadFile método para indicarle que sobrescriba los archivos existentes, proporcione credenciales de usuario o especifique un valor de tiempo de espera específico. DownloadFile genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Habilitación del seguimiento de red.

Nota

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.Network.DownloadFile método .

En	Vea
Descarga de un archivo	Procedimiento para descargar un archivo

Consulte también

Se aplica a

DownloadFile(String, String, String, String)

Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);

public void DownloadFile (string address, string destinationFileName, string userName, string password);

member this.DownloadFile : string * string * string * string -> unit

Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String)

Parámetros

address: String

Ruta de acceso al archivo que se va a descargar, incluidos el nombre de archivo y la dirección del host.

destinationFileName: String

Nombre de archivo y ruta de acceso al archivo descargado.

userName: String

Nombre de usuario que se va a autenticar. Su valor predeterminado es una cadena vacía, "".

password: String

Contraseña para autenticar. Su valor predeterminado es una cadena vacía, "".

Excepciones

ArgumentException

destinationFileName finaliza con una barra oblicua final.

TimeoutException

El servidor no responde dentro del tiempo de espera predeterminado (100 segundos).

SecurityException

Al usuario le faltan los permisos necesarios para realizar una operación de red.

WebException

La solicitud es denegado por el servidor web de destino.

Ejemplos

En este ejemplo se descarga el archivo WineList.txt de 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")

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

Comentarios

DownloadFile genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Habilitación del seguimiento de red.

Nota

El protocolo FTP envía información, incluidas las contraseñas, en texto sin formato y no debe usarse para transmitir información confidencial.

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.Network.DownloadFile método .

En	Vea
Descarga de un archivo	Procedimiento para descargar un archivo

Consulte también

Se aplica a

DownloadFile(Uri, String, String, String)

Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);

public void DownloadFile (Uri address, string destinationFileName, string userName, string password);

member this.DownloadFile : Uri * string * string * string -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String)

Parámetros

address: Uri

Ruta de acceso al archivo que se va a descargar, incluidos el nombre de archivo y la dirección del host.

destinationFileName: String

Nombre de archivo y ruta de acceso al archivo descargado.

userName: String

Nombre de usuario que se va a autenticar. Su valor predeterminado es una cadena vacía, "".

password: String

Contraseña para autenticar. Su valor predeterminado es una cadena vacía, "".

Excepciones

ArgumentException

destinationFileName finaliza con una barra oblicua final.

TimeoutException

El servidor no responde dentro del tiempo de espera predeterminado (100 segundos).

SecurityException

Al usuario le faltan los permisos necesarios para realizar una operación de red.

WebException

La solicitud es denegado por el servidor web de destino.

Ejemplos

En este ejemplo se descarga el archivo WineList.txt de 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")

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

Comentarios

DownloadFile genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Habilitación del seguimiento de red.

Nota

El protocolo FTP envía información, incluidas las contraseñas, en texto sin formato y no debe usarse para transmitir información confidencial.

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.Network.DownloadFile método .

En	Vea
Descarga de un archivo	Procedimiento para descargar un archivo

Consulte también

Se aplica a

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)

Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite);

public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite);

member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Parámetros

address: Uri

String o Uri. Ruta de acceso al archivo que se va a descargar, incluidos el nombre de archivo y la dirección del host.

destinationFileName: String

String. Nombre de archivo y ruta de acceso al archivo descargado.

networkCredentials: ICredentials

ICredentials. Credenciales que se van a proporcionar.

showUI: Boolean

True para mostrar el progreso de la operación; de lo contrario, False. El valor predeterminado es False.

connectionTimeout: Int32

Intervalo de tiempo de espera en milisegundos. El valor predeterminado es 100 segundos.

overwrite: Boolean

True para sobrescribir los archivos existentes; de lo contrario, False. El valor predeterminado es False.

Excepciones

ArgumentException

destinationFileName finaliza con una barra oblicua final.

IOException

overwrite está establecido en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del valor de connectionTimeout especificado.

SecurityException

Al usuario le faltan los permisos necesarios para realizar una operación de red.

WebException

La solicitud es denegado por el servidor web de destino.

Ejemplos

En este ejemplo se descarga el archivo WineList.txt de 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")

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

Comentarios

Si showUI se establece Trueen , aparece un cuadro de diálogo que muestra el progreso de la operación; el cuadro de diálogo contiene un botón Cancelar que se puede usar para cancelar la operación. El cuadro de diálogo no es modal y, por lo tanto, no bloquea la entrada del usuario a otras ventanas del programa.

Si el servidor no responde dentro del especificado connectionTimeout, se cancela la operación y se produce una excepción.

DownloadFile genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Habilitación del seguimiento de red.

Nota

El protocolo FTP envía información, incluidas las contraseñas, en texto sin formato y no debe usarse para transmitir información confidencial.

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.Network.DownloadFile método .

En	Vea
Descarga de un archivo	Procedimiento para descargar un archivo

Consulte también

Se aplica a

DownloadFile(String, String, String, String, Boolean, Int32, Boolean)

Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);

public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);

member this.DownloadFile : string * string * string * string * bool * int * bool -> unit

Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Parámetros

address: String

Ruta de acceso al archivo que se va a descargar, incluidos el nombre de archivo y la dirección del host.

destinationFileName: String

Nombre de archivo y ruta de acceso al archivo descargado.

userName: String

Nombre de usuario que se va a autenticar. Su valor predeterminado es una cadena vacía, "".

password: String

Contraseña para autenticar. Su valor predeterminado es una cadena vacía, "".

showUI: Boolean

True para mostrar el progreso de la operación; de lo contrario, False. El valor predeterminado es False.

connectionTimeout: Int32

Int32. Intervalo de tiempo de espera en milisegundos. El valor predeterminado es 100 segundos.

overwrite: Boolean

True para sobrescribir los archivos existentes; de lo contrario, False. El valor predeterminado es False.

Excepciones

ArgumentException

destinationFileName finaliza con una barra oblicua final.

IOException

overwrite está establecido en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del valor de connectionTimeout especificado.

SecurityException

Al usuario le faltan los permisos necesarios para realizar una operación de red.

WebException

La solicitud es denegado por el servidor web de destino.

Ejemplos

En este ejemplo se descarga el archivo WineList.txt de 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")

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

Comentarios

Si el servidor no responde dentro del especificado connectionTimeout, se cancela la operación y se produce una excepción.

DownloadFile genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Habilitación del seguimiento de red.

Nota

El protocolo FTP envía información, incluidas las contraseñas, en texto sin formato y no debe usarse para transmitir información confidencial.

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.Network.DownloadFile método .

En	Vea
Descarga de un archivo	Procedimiento para descargar un archivo

Consulte también

Se aplica a

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)

Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Parámetros

address: Uri

Ruta de acceso al archivo que se va a descargar, incluidos el nombre de archivo y la dirección del host.

destinationFileName: String

Nombre de archivo y ruta de acceso al archivo descargado.

networkCredentials: ICredentials

Credenciales que se van a proporcionar.

showUI: Boolean

True para mostrar el progreso de la operación; de lo contrario, False. El valor predeterminado es False.

connectionTimeout: Int32

Intervalo de tiempo de espera en milisegundos. El valor predeterminado es 100 segundos.

overwrite: Boolean

True para sobrescribir los archivos existentes; de lo contrario, False. El valor predeterminado es False.

onUserCancel: UICancelOption

Especifica el comportamiento que se produce cuando el usuario hace clic en Cancelar o en No en el cuadro de diálogo que se muestra cuando el valor de showUI se establece en True. El valor predeterminado es ThrowException.

Excepciones

ArgumentException

destinationFileName finaliza con una barra oblicua final.

IOException

overwrite está establecido en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del valor de connectionTimeout especificado.

SecurityException

Al usuario le faltan los permisos necesarios para realizar una operación de red.

WebException

La solicitud es denegado por el servidor web de destino.

Ejemplos

En este ejemplo se descarga el archivo WineList.txt de 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")

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

Comentarios

Si el servidor no responde dentro de la operación especificada connectionTimeout, se cancela la operación y se produce una excepción.

DownloadFile genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Habilitación del seguimiento de red.

Nota

El protocolo FTP envía información, incluidas las contraseñas, en texto sin formato y no debe usarse para transmitir información confidencial.

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.Network.DownloadFile método .

En	Vea
Descarga de un archivo	Procedimiento para descargar un archivo

Consulte también

Se aplica a

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)

Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);

public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);

member this.DownloadFile : Uri * string * string * string * bool * int * bool -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Parámetros

address: Uri

Ruta de acceso al archivo que se va a descargar, incluidos el nombre de archivo y la dirección del host.

destinationFileName: String

Nombre de archivo y ruta de acceso al archivo descargado.

userName: String

Nombre de usuario que se va a autenticar. Su valor predeterminado es una cadena vacía, "".

password: String

Contraseña para autenticar. Su valor predeterminado es una cadena vacía, "".

showUI: Boolean

True para mostrar el progreso de la operación; de lo contrario, False. El valor predeterminado es False.

connectionTimeout: Int32

Intervalo de tiempo de espera en milisegundos. El valor predeterminado es 100 segundos.

overwrite: Boolean

True para sobrescribir los archivos existentes; de lo contrario, False. El valor predeterminado es False.

Excepciones

ArgumentException

destinationFileName finaliza con una barra oblicua final.

IOException

overwrite está establecido en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del valor de connectionTimeout especificado.

SecurityException

Al usuario le faltan los permisos necesarios para realizar una operación de red.

WebException

La solicitud es denegado por el servidor web de destino.

Ejemplos

En este ejemplo se descarga el archivo WineList.txt de 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")

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

Comentarios

Si el servidor no responde dentro de la operación especificada connectionTimeout, se cancela la operación y se produce una excepción.

DownloadFile genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Habilitación del seguimiento de red.

Nota

El protocolo FTP envía información, incluidas las contraseñas, en texto sin formato y no debe usarse para transmitir información confidencial.

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.Network.DownloadFile método .

En	Vea
Descarga de un archivo	Procedimiento para descargar un archivo

Consulte también

Se aplica a

DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DownloadFile : string * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Parámetros

address: String

Ruta de acceso al archivo que se va a descargar, incluidos el nombre de archivo y la dirección del host.

destinationFileName: String

Nombre de archivo y ruta de acceso al archivo descargado.

userName: String

Nombre de usuario que se va a autenticar. Su valor predeterminado es una cadena vacía, "".

password: String

Contraseña para autenticar. Su valor predeterminado es una cadena vacía, "".

showUI: Boolean

True para mostrar el progreso de la operación; de lo contrario, False. El valor predeterminado es False.

connectionTimeout: Int32

Intervalo de tiempo de espera en milisegundos. El valor predeterminado es 100 segundos.

overwrite: Boolean

True para sobrescribir los archivos existentes; de lo contrario, False. El valor predeterminado es False.

onUserCancel: UICancelOption

Especifica el comportamiento que se produce cuando el usuario hace clic en Cancelar o en No en el cuadro de diálogo que se muestra cuando el valor de ShowUI se establece en True. El valor predeterminado es ThrowException.

Excepciones

ArgumentException

destinationFileName finaliza con una barra oblicua final.

IOException

overwrite está establecido en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del valor de connectionTimeout especificado.

SecurityException

Al usuario le faltan los permisos necesarios para realizar una operación de red.

WebException

La solicitud es denegado por el servidor web de destino.

Ejemplos

En este ejemplo se descarga el archivo WineList.txt de 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")

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

Comentarios

Si el servidor no responde dentro del especificado connectionTimeout, se cancela la operación y se produce una excepción.

DownloadFile genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Habilitación del seguimiento de red.

Nota

El protocolo FTP envía información, incluidas las contraseñas, en texto sin formato y no debe usarse para transmitir información confidencial.

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.Network.DownloadFile método .

En	Vea
Descarga de un archivo	Procedimiento para descargar un archivo

Consulte también

Se aplica a

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Descarga el archivo remoto especificado y lo guarda en la ubicación indicada.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DownloadFile : Uri * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Parámetros

address: Uri

Ruta de acceso al archivo que se va a descargar, incluidos el nombre de archivo y la dirección del host.

destinationFileName: String

Nombre de archivo y ruta de acceso al archivo descargado.

userName: String

Nombre de usuario que se va a autenticar. Su valor predeterminado es una cadena vacía, "".

password: String

Contraseña para autenticar. Su valor predeterminado es una cadena vacía, "".

showUI: Boolean

True para mostrar el progreso de la operación; de lo contrario, False. El valor predeterminado es False.

connectionTimeout: Int32

Intervalo de tiempo de espera en milisegundos. El valor predeterminado es 100 segundos.

overwrite: Boolean

True para sobrescribir los archivos existentes; de lo contrario, False. El valor predeterminado es False.

onUserCancel: UICancelOption

Excepciones

ArgumentException

destinationFileName finaliza con una barra oblicua final.

IOException

overwrite está establecido en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del valor de connectionTimeout especificado.

SecurityException

Al usuario le faltan los permisos necesarios para realizar una operación de red.

WebException

La solicitud es denegado por el servidor web de destino.

Ejemplos

En este ejemplo se descarga el archivo WineList.txt de 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")

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

Comentarios

Si el servidor no responde dentro del especificado connectionTimeout, se cancela la operación y se produce una excepción.

DownloadFile genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte Habilitación del seguimiento de red.

Nota

El protocolo FTP envía información, incluidas las contraseñas, en texto sin formato y no debe usarse para transmitir información confidencial.

En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.Network.DownloadFile método .

En	Vea
Descarga de un archivo	Procedimiento para descargar un archivo

Consulte también

Se aplica a

Compartir a través de

Network.DownloadFile Método

Definición

Sobrecargas

DownloadFile(String, String)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DownloadFile(Uri, String)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DownloadFile(String, String, String, String)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DownloadFile(Uri, String, String, String)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DownloadFile(String, String, String, String, Boolean, Int32, Boolean)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Parámetros

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales