Network.DownloadFile Método

Definición

Espacio de nombres:: Microsoft.VisualBasic.Devices

Ensamblado:: Microsoft.VisualBasic.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 especificada.

Sobrecargas

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

DownloadFile(String, String)

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

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 del archivo que se va a descargar, incluido el nombre de archivo y la dirección de host.

destinationFileName: String

Nombre de archivo y ruta de acceso del archivo descargado.

Excepciones

ArgumentException

destinationFileName termina con una barra diagonal final.

TimeoutException

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

SecurityException

El usuario carece de permisos necesarios para realizar una operación de red.

WebException

El servidor web de destino deniega la solicitud.

Ejemplos

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 .

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 del agente de usuario opcional. 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
Descargar un archivo	Cómo: Descargar un archivo

Consulte también

Se aplica a

DownloadFile(Uri, String)

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

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 del archivo que se va a descargar, incluido el nombre de archivo y la dirección de host.

destinationFileName: String

Nombre de archivo y ruta de acceso del archivo descargado.

Excepciones

ArgumentException

destinationFileName termina con una barra diagonal final.

TimeoutException

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

SecurityException

El usuario carece de permisos necesarios para realizar una operación de red.

WebException

El servidor web de destino deniega la solicitud.

Ejemplos

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 .

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
Descargar un archivo	Cómo: 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 especificada.

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 del archivo que se va a descargar, incluido el nombre de archivo y la dirección de host.

destinationFileName: String

Nombre de archivo y ruta de acceso del archivo descargado.

userName: String

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

password: String

Contraseña para autenticarse. El valor predeterminado es una cadena vacía, "".

Excepciones

ArgumentException

destinationFileName termina con una barra diagonal final.

TimeoutException

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

SecurityException

El usuario carece de permisos necesarios para realizar una operación de red.

WebException

El servidor web de destino deniega la solicitud.

Ejemplos

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 .

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
Descargar un archivo	Cómo: 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 especificada.

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 del archivo que se va a descargar, incluido el nombre de archivo y la dirección de host.

destinationFileName: String

Nombre de archivo y ruta de acceso del archivo descargado.

userName: String

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

password: String

Contraseña para autenticarse. El valor predeterminado es una cadena vacía, "".

Excepciones

ArgumentException

destinationFileName termina con una barra diagonal final.

TimeoutException

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

SecurityException

El usuario carece de permisos necesarios para realizar una operación de red.

WebException

El servidor web de destino deniega la solicitud.

Ejemplos

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 .

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
Descargar un archivo	Cómo: 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 especificada.

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 del archivo que se va a descargar, incluido el nombre de archivo y la dirección de host.

destinationFileName: String

String. Nombre de archivo y ruta de acceso del 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, es . 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, es . El valor predeterminado es False.

Excepciones

ArgumentException

destinationFileName termina con una barra diagonal final.

IOException

overwrite se establece en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del especificado connectionTimeout.

SecurityException

El usuario carece de permisos necesarios para realizar una operación de red.

WebException

El servidor web de destino deniega la solicitud.

Ejemplos

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 .

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
Descargar un archivo	Cómo: 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 especificada.

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 del archivo que se va a descargar, incluido el nombre de archivo y la dirección de host.

destinationFileName: String

Nombre de archivo y ruta de acceso del archivo descargado.

userName: String

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

password: String

Contraseña para autenticarse. El valor predeterminado es una cadena vacía, "".

showUI: Boolean

True para mostrar el progreso de la operación; de lo contrario False, es . 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, es . El valor predeterminado es False.

Excepciones

ArgumentException

destinationFileName termina con una barra diagonal final.

IOException

overwrite se establece en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del especificado connectionTimeout.

SecurityException

El usuario carece de permisos necesarios para realizar una operación de red.

WebException

El servidor web de destino deniega la solicitud.

Ejemplos

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 .

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
Descargar un archivo	Cómo: 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 especificada.

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 del archivo que se va a descargar, incluido el nombre de archivo y la dirección de host.

destinationFileName: String

Nombre de archivo y ruta de acceso del 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, es . 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, es . El valor predeterminado es False.

onUserCancel: UICancelOption

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

Excepciones

ArgumentException

destinationFileName termina con una barra diagonal final.

IOException

overwrite se establece en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del especificado connectionTimeout.

SecurityException

El usuario carece de permisos necesarios para realizar una operación de red.

WebException

El servidor web de destino deniega la solicitud.

Ejemplos

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 .

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
Descargar un archivo	Cómo: 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 especificada.

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 del archivo que se va a descargar, incluido el nombre de archivo y la dirección de host.

destinationFileName: String

Nombre de archivo y ruta de acceso del archivo descargado.

userName: String

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

password: String

Contraseña para autenticarse. El valor predeterminado es una cadena vacía, "".

showUI: Boolean

True para mostrar el progreso de la operación; de lo contrario False, es . 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, es . El valor predeterminado es False.

Excepciones

ArgumentException

destinationFileName termina con una barra diagonal final.

IOException

overwrite se establece en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del especificado connectionTimeout.

SecurityException

El usuario carece de permisos necesarios para realizar una operación de red.

WebException

El servidor web de destino deniega la solicitud.

Ejemplos

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 .

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
Descargar un archivo	Cómo: 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 especificada.

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 del archivo que se va a descargar, incluido el nombre de archivo y la dirección de host.

destinationFileName: String

Nombre de archivo y ruta de acceso del archivo descargado.

userName: String

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

password: String

Contraseña para autenticarse. El valor predeterminado es una cadena vacía, "".

showUI: Boolean

True para mostrar el progreso de la operación; de lo contrario False, es . 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, es . El valor predeterminado es False.

onUserCancel: UICancelOption

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

Excepciones

ArgumentException

destinationFileName termina con una barra diagonal final.

IOException

overwrite se establece en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del especificado connectionTimeout.

SecurityException

El usuario carece de permisos necesarios para realizar una operación de red.

WebException

El servidor web de destino deniega la solicitud.

Ejemplos

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 .

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
Descargar un archivo	Cómo: 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 especificada.

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 del archivo que se va a descargar, incluido el nombre de archivo y la dirección de host.

destinationFileName: String

Nombre de archivo y ruta de acceso del archivo descargado.

userName: String

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

password: String

Contraseña para autenticarse. El valor predeterminado es una cadena vacía, "".

showUI: Boolean

True para mostrar el progreso de la operación; de lo contrario False, es . 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, es . El valor predeterminado es False.

onUserCancel: UICancelOption

Excepciones

ArgumentException

destinationFileName termina con una barra diagonal final.

IOException

overwrite se establece en False y el archivo de destino ya existe.

TimeoutException

El servidor no responde dentro del especificado connectionTimeout.

SecurityException

El usuario carece de permisos necesarios para realizar una operación de red.

WebException

El servidor web de destino deniega la solicitud.

Ejemplos

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 .

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
Descargar un archivo	Cómo: Descargar un archivo

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?