Comparteix a través de


Network.DownloadFile Método

Definición

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

destinationFileName finaliza con una barra oblicua final.

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

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

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

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

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

destinationFileName finaliza con una barra oblicua final.

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

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

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

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

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

destinationFileName finaliza con una barra oblicua final.

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

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

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

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

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 .

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

destinationFileName finaliza con una barra oblicua final.

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

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

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

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

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 .

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

destinationFileName finaliza con una barra oblicua final.

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

El servidor no responde dentro del valor de connectionTimeout especificado.

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

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

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

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

destinationFileName finaliza con una barra oblicua final.

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

El servidor no responde dentro del valor de connectionTimeout especificado.

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

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

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

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

destinationFileName finaliza con una barra oblicua final.

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

El servidor no responde dentro del valor de connectionTimeout especificado.

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

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

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

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

destinationFileName finaliza con una barra oblicua final.

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

El servidor no responde dentro del valor de connectionTimeout especificado.

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

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

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

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

destinationFileName finaliza con una barra oblicua final.

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

El servidor no responde dentro del valor de connectionTimeout especificado.

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

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

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

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

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

destinationFileName finaliza con una barra oblicua final.

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

El servidor no responde dentro del valor de connectionTimeout especificado.

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

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

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

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