Network.DownloadFile Método
Definición
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 -> unitPublic 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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Cómo: Descargar un archivo en Visual Basic
- Cómo: Analizar rutas de acceso a archivos en Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Cómo: Descargar un archivo en Visual Basic
- Cómo: Analizar rutas de acceso a archivos en Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Cómo: Descargar un archivo en Visual Basic
- Cómo: Analizar rutas de acceso a archivos en Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Cómo: Descargar un archivo en Visual Basic
- Cómo: Analizar rutas de acceso a archivos en Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Cómo: Descargar un archivo en Visual Basic
- Cómo: Analizar rutas de acceso a archivos en Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Cómo: Descargar un archivo en Visual Basic
- Cómo: Analizar rutas de acceso a archivos en Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Cómo: Descargar un archivo en Visual Basic
- Cómo: Analizar rutas de acceso a archivos en Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Cómo: Descargar un archivo en Visual Basic
- Cómo: Analizar rutas de acceso a archivos en Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Cómo: Descargar un archivo en Visual Basic
- Cómo: Analizar rutas de acceso a archivos en Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Cómo: Descargar un archivo en Visual Basic
- Cómo: Analizar rutas de acceso a archivos en Visual Basic
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de