Network.DownloadFile Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic.Devices

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Descarrega o ficheiro remoto especificado e guarda-o na localização indicada.

Sobrecargas

Name	Description
DownloadFile(String, String)	Descarrega o ficheiro remoto especificado e guarda-o na localização indicada.
DownloadFile(Uri, String)	Descarrega o ficheiro remoto especificado e guarda-o na localização indicada.
DownloadFile(String, String, String, String)	Descarrega o ficheiro remoto especificado e guarda-o na localização indicada.
DownloadFile(Uri, String, String, String)	Descarrega o ficheiro remoto especificado e guarda-o na localização indicada.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)	Descarrega o ficheiro remoto especificado e guarda-o na localização indicada.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)	Descarrega o ficheiro remoto especificado e guarda-o na localização indicada.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)	Descarrega o ficheiro remoto especificado e guarda-o na localização indicada.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)	Descarrega o ficheiro remoto especificado e guarda-o na localização indicada.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Descarrega o ficheiro remoto especificado e guarda-o na localização indicada.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Descarrega o ficheiro remoto especificado e guarda-o na localização indicada.

DownloadFile(String, String)

Descarrega o ficheiro remoto especificado e guarda-o na localização 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

Caminho do ficheiro a descarregar, incluindo nome do ficheiro e endereço do host.

destinationFileName: String

Nome do ficheiro e caminho do ficheiro descarregado.

Exceções

ArgumentException

destinationFileName termina com um corte final.

TimeoutException

O servidor não responde dentro do timeout padrão (100 segundos).

SecurityException

O utilizador não possui as permissões necessárias para realizar uma operação em rede.

WebException

O pedido é recusado pelo servidor web alvo.

Exemplos

Este exemplo descarrega o ficheiro WineList.txt de http://www.cohowinery.com/downloads e guarda-o em 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")

Este exemplo descarrega o ficheiro WineList.txt e http://www.cohowinery.com/downloads guarda-o em C:\Documents and Settings\All Users\Documents, especificando um intervalo de tempo de 500 milissegundos.

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

Observações

DownloadFile Gera informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Ativar o Rastreio de Rede.

Note

O DownloadFile método não envia cabeçalhos HTTP opcionais. Alguns servidores podem devolver 500 (Erro de Servidor Interno) se o cabeçalho opcional do agente de utilizador estiver em falta. Para enviar cabeçalhos opcionais, deve construir um pedido usando a WebClient classe.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.Network.DownloadFile método.

Para	Veja
Descarregar um ficheiro	Como: Baixar um arquivo

Ver também

Aplica-se a

DownloadFile(Uri, String)

Descarrega o ficheiro remoto especificado e guarda-o na localização 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

Caminho do ficheiro a descarregar, incluindo nome do ficheiro e endereço do host.

destinationFileName: String

Nome do ficheiro e caminho do ficheiro descarregado.

Exceções

ArgumentException

destinationFileName termina com um corte final.

TimeoutException

O servidor não responde dentro do timeout padrão (100 segundos).

SecurityException

O utilizador não possui as permissões necessárias para realizar uma operação em rede.

WebException

O pedido é recusado pelo servidor web alvo.

Exemplos

Este exemplo descarrega o ficheiro WineList.txt de http://www.cohowinery.com/downloads e guarda-o em C:\Documents and Settings\All Users\Documents.

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

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

Observações

Se o ficheiro de destino já existir, o DownloadFile método não irá sobrescrever o ficheiro existente. Pode usar uma das outras sobrecargas do DownloadFile método para o instruir a sobrescrever ficheiros existentes, fornecer credenciais de utilizador ou especificar um valor de timeout específico. DownloadFile Gera informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Ativar o Rastreio de Rede.

Note

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.Network.DownloadFile método.

Para	Veja
Descarregar um ficheiro	Como: Baixar um arquivo

Ver também

Aplica-se a

DownloadFile(String, String, String, String)

Descarrega o ficheiro remoto especificado e guarda-o na localização 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

Caminho do ficheiro a descarregar, incluindo nome do ficheiro e endereço do host.

destinationFileName: String

Nome do ficheiro e caminho do ficheiro descarregado.

userName: String

Nome de utilizador para autenticar. O padrão é uma cadeia vazia, "".

password: String

Palavra-passe para autenticar. O padrão é uma cadeia vazia, "".

Exceções

ArgumentException

destinationFileName termina com um corte final.

TimeoutException

O servidor não responde dentro do timeout padrão (100 segundos).

SecurityException

O utilizador não possui as permissões necessárias para realizar uma operação em rede.

WebException

O pedido é recusado pelo servidor web alvo.

Exemplos

Este exemplo descarrega o ficheiro WineList.txt de http://www.cohowinery.com/downloads e guarda-o em C:\Documents and Settings\All Users\Documents.

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

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

Observações

Se o ficheiro de destino já existir, o DownloadFile método não irá sobrescrever o ficheiro existente. Podes usar uma das outras sobrecargas do DownloadFile método para o instruir a sobrescrever ficheiros existentes ou especificar um valor de timeout específico.

DownloadFile Gera informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Ativar o Rastreio de Rede.

Note

O protocolo FTP envia informação, incluindo palavras-passe, em texto simples e não deve ser usado para transmitir informações sensíveis.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.Network.DownloadFile método.

Para	Veja
Descarregar um ficheiro	Como: Baixar um arquivo

Ver também

Aplica-se a

DownloadFile(Uri, String, String, String)

Descarrega o ficheiro remoto especificado e guarda-o na localização 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

Caminho do ficheiro a descarregar, incluindo nome do ficheiro e endereço do host.

destinationFileName: String

Nome do ficheiro e caminho do ficheiro descarregado.

userName: String

Nome de utilizador para autenticar. O padrão é uma cadeia vazia, "".

password: String

Palavra-passe para autenticar. O padrão é uma cadeia vazia, "".

Exceções

ArgumentException

destinationFileName termina com um corte final.

TimeoutException

O servidor não responde dentro do timeout padrão (100 segundos).

SecurityException

O utilizador não possui as permissões necessárias para realizar uma operação em rede.

WebException

O pedido é recusado pelo servidor web alvo.

Exemplos

Este exemplo descarrega o ficheiro WineList.txt de http://www.cohowinery.com/downloads e guarda-o em C:\Documents and Settings\All Users\Documents.

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

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

Observações

DownloadFile Gera informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Ativar o Rastreio de Rede.

Note

O protocolo FTP envia informação, incluindo palavras-passe, em texto simples e não deve ser usado para transmitir informações sensíveis.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.Network.DownloadFile método.

Para	Veja
Descarregar um ficheiro	Como: Baixar um arquivo

Ver também

Aplica-se a

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

Descarrega o ficheiro remoto especificado e guarda-o na localização 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 ou Uri. Caminho do ficheiro a descarregar, incluindo nome do ficheiro e endereço do host.

destinationFileName: String

String. Nome do ficheiro e caminho do ficheiro descarregado.

networkCredentials: ICredentials

ICredentials. Credenciais a serem fornecidas.

showUI: Boolean

True mostrar o progresso da operação; caso contrário False. A predefinição é False.

connectionTimeout: Int32

Intervalo de timeout, em milissegundos. O padrão é 100 segundos.

overwrite: Boolean

True sobrescrever ficheiros existentes; caso contrário False. A predefinição é False.

Exceções

ArgumentException

destinationFileName termina com um corte final.

IOException

overwrite está definido como False e o ficheiro de destino já existe.

TimeoutException

O servidor não responde dentro do especificado connectionTimeout.

SecurityException

O utilizador não possui as permissões necessárias para realizar uma operação em rede.

WebException

O pedido é recusado pelo servidor web alvo.

Exemplos

Este exemplo descarrega o ficheiro WineList.txt de http://www.cohowinery.com/downloads e guarda-o em C:\Documents and Settings\All Users\Documents.

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

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

Observações

Se showUI estiver definido para True, aparece uma caixa de diálogo que mostra o progresso da operação; a caixa de diálogo contém um botão Cancelar que pode ser usado para cancelar a operação. A caixa de diálogo não é modal e, por isso, não bloqueia a entrada do utilizador para outras janelas do programa.

Se o servidor não responder dentro do especificado connectionTimeout, a operação é cancelada e é lançada uma exceção.

DownloadFile Gera informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Ativar o Rastreio de Rede.

Note

O protocolo FTP envia informação, incluindo palavras-passe, em texto simples e não deve ser usado para transmitir informações sensíveis.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.Network.DownloadFile método.

Para	Veja
Descarregar um ficheiro	Como: Baixar um arquivo

Ver também

Aplica-se a

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

Descarrega o ficheiro remoto especificado e guarda-o na localização 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

Caminho do ficheiro a descarregar, incluindo nome do ficheiro e endereço do host.

destinationFileName: String

Nome do ficheiro e caminho do ficheiro descarregado.

userName: String

Nome de utilizador para autenticar. O padrão é uma cadeia vazia, "".

password: String

Palavra-passe para autenticar. O padrão é uma cadeia vazia, "".

showUI: Boolean

True mostrar o progresso da operação; caso contrário False. A predefinição é False.

connectionTimeout: Int32

Int32. Intervalo de timeout, em milissegundos. O padrão é 100 segundos.

overwrite: Boolean

True sobrescrever ficheiros existentes; caso contrário False. A predefinição é False.

Exceções

ArgumentException

destinationFileName termina com um corte final.

IOException

overwrite está definido como False e o ficheiro de destino já existe.

TimeoutException

O servidor não responde dentro do especificado connectionTimeout.

SecurityException

O utilizador não possui as permissões necessárias para realizar uma operação em rede.

WebException

O pedido é recusado pelo servidor web alvo.

Exemplos

Este exemplo descarrega o ficheiro WineList.txt de http://www.cohowinery.com/downloads e guarda-o em C:\Documents and Settings\All Users\Documents.

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

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

Observações

Se o servidor não responder dentro do especificado connectionTimeout, a operação é cancelada e é lançada uma exceção.

DownloadFile Gera informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Ativar o Rastreio de Rede.

Note

O protocolo FTP envia informação, incluindo palavras-passe, em texto simples e não deve ser usado para transmitir informações sensíveis.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.Network.DownloadFile método.

Para	Veja
Descarregar um ficheiro	Como: Baixar um arquivo

Ver também

Aplica-se a

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

Descarrega o ficheiro remoto especificado e guarda-o na localização 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

Caminho do ficheiro a descarregar, incluindo nome do ficheiro e endereço do host.

destinationFileName: String

Nome do ficheiro e caminho do ficheiro descarregado.

networkCredentials: ICredentials

Credenciais a serem fornecidas.

showUI: Boolean

True mostrar o progresso da operação; caso contrário False. A predefinição é False.

connectionTimeout: Int32

Intervalo de timeout, em milissegundos. O padrão é 100 segundos.

overwrite: Boolean

True sobrescrever ficheiros existentes; caso contrário False. A predefinição é False.

onUserCancel: UICancelOption

Especifica o comportamento quando o utilizador clica em Cancelar ou Não na caixa de diálogo mostrada como resultado de showUI definir para True. A predefinição é ThrowException.

Exceções

ArgumentException

destinationFileName termina com um corte final.

IOException

overwrite está definido como False e o ficheiro de destino já existe.

TimeoutException

O servidor não responde dentro do especificado connectionTimeout.

SecurityException

O utilizador não possui as permissões necessárias para realizar uma operação em rede.

WebException

O pedido é recusado pelo servidor web alvo.

Exemplos

Este exemplo descarrega o ficheiro WineList.txt de http://www.cohowinery.com/downloads e guarda-o em C:\Documents and Settings\All Users\Documents.

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

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

Observações

Se o servidor não responder dentro do especificado connectionTimeout, a operação é cancelada e é lançada uma exceção.

DownloadFile Gera informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Ativar o Rastreio de Rede.

Note

O protocolo FTP envia informação, incluindo palavras-passe, em texto simples e não deve ser usado para transmitir informações sensíveis.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.Network.DownloadFile método.

Para	Veja
Descarregar um ficheiro	Como: Baixar um arquivo

Ver também

Aplica-se a

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

Descarrega o ficheiro remoto especificado e guarda-o na localização 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

Caminho do ficheiro a descarregar, incluindo nome do ficheiro e endereço do host.

destinationFileName: String

Nome do ficheiro e caminho do ficheiro descarregado.

userName: String

Nome de utilizador para autenticar. O padrão é uma cadeia vazia, "".

password: String

Palavra-passe para autenticar. O padrão é uma cadeia vazia, "".

showUI: Boolean

True mostrar o progresso da operação; caso contrário False. A predefinição é False.

connectionTimeout: Int32

Intervalo de timeout, em milissegundos. O padrão é 100 segundos.

overwrite: Boolean

True sobrescrever ficheiros existentes; caso contrário False. A predefinição é False.

Exceções

ArgumentException

destinationFileName termina com um corte final.

IOException

overwrite está definido como False e o ficheiro de destino já existe.

TimeoutException

O servidor não responde dentro do especificado connectionTimeout.

SecurityException

O utilizador não possui as permissões necessárias para realizar uma operação em rede.

WebException

O pedido é recusado pelo servidor web alvo.

Exemplos

Este exemplo descarrega o ficheiro WineList.txt de http://www.cohowinery.com/downloads e guarda-o em C:\Documents and Settings\All Users\Documents.

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

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

Observações

Se o servidor não responder dentro do especificado connectionTimeout, a operação é cancelada e é lançada uma exceção.

DownloadFile Gera informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Ativar o Rastreio de Rede.

Note

O protocolo FTP envia informação, incluindo palavras-passe, em texto simples e não deve ser usado para transmitir informações sensíveis.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.Network.DownloadFile método.

Para	Veja
Descarregar um ficheiro	Como: Baixar um arquivo

Ver também

Aplica-se a

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

Descarrega o ficheiro remoto especificado e guarda-o na localização 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

Caminho do ficheiro a descarregar, incluindo nome do ficheiro e endereço do host.

destinationFileName: String

Nome do ficheiro e caminho do ficheiro descarregado.

userName: String

Nome de utilizador para autenticar. O padrão é uma cadeia vazia, "".

password: String

Palavra-passe para autenticar. O padrão é uma cadeia vazia, "".

showUI: Boolean

True mostrar o progresso da operação; caso contrário False. A predefinição é False.

connectionTimeout: Int32

Intervalo de timeout, em milissegundos. O padrão é 100 segundos.

overwrite: Boolean

True sobrescrever ficheiros existentes; caso contrário False. A predefinição é False.

onUserCancel: UICancelOption

Especifica o comportamento quando o utilizador clica em Cancelar ou Não na caixa de diálogo mostrada como resultado de ShowUI definir para True. A predefinição é ThrowException.

Exceções

ArgumentException

destinationFileName termina com um corte final.

IOException

overwrite está definido como False e o ficheiro de destino já existe.

TimeoutException

O servidor não responde dentro do especificado connectionTimeout.

SecurityException

O utilizador não possui as permissões necessárias para realizar uma operação em rede.

WebException

O pedido é recusado pelo servidor web alvo.

Exemplos

Este exemplo descarrega o ficheiro WineList.txt de http://www.cohowinery.com/downloads e guarda-o em C:\Documents and Settings\All Users\Documents.

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

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

Observações

Se o servidor não responder dentro do especificado connectionTimeout, a operação é cancelada e é lançada uma exceção.

DownloadFile Gera informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Ativar o Rastreio de Rede.

Note

O protocolo FTP envia informação, incluindo palavras-passe, em texto simples e não deve ser usado para transmitir informações sensíveis.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.Network.DownloadFile método.

Para	Veja
Descarregar um ficheiro	Como: Baixar um arquivo

Ver também

Aplica-se a

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

Descarrega o ficheiro remoto especificado e guarda-o na localização 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

Caminho do ficheiro a descarregar, incluindo nome do ficheiro e endereço do host.

destinationFileName: String

Nome do ficheiro e caminho do ficheiro descarregado.

userName: String

Nome de utilizador para autenticar. O padrão é uma cadeia vazia, "".

password: String

Palavra-passe para autenticar. O padrão é uma cadeia vazia, "".

showUI: Boolean

True mostrar o progresso da operação; caso contrário False. A predefinição é False.

connectionTimeout: Int32

Intervalo de timeout, em milissegundos. O padrão é 100 segundos.

overwrite: Boolean

True sobrescrever ficheiros existentes; caso contrário False. A predefinição é False.

onUserCancel: UICancelOption

Especifica o comportamento quando o utilizador clica em Cancelar ou Não na caixa de diálogo mostrada como resultado de ShowUI definir para True. A predefinição é ThrowException.

Exceções

ArgumentException

destinationFileName termina com um corte final.

IOException

overwrite está definido como False e o ficheiro de destino já existe.

TimeoutException

O servidor não responde dentro do especificado connectionTimeout.

SecurityException

O utilizador não possui as permissões necessárias para realizar uma operação em rede.

WebException

O pedido é recusado pelo servidor web alvo.

Exemplos

Este exemplo descarrega o ficheiro WineList.txt de http://www.cohowinery.com/downloads e guarda-o em C:\Documents and Settings\All Users\Documents.

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

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

Observações

Se o servidor não responder dentro do especificado connectionTimeout, a operação é cancelada e é lançada uma exceção.

DownloadFile Gera informação de rastreio quando ativa o rastreio de rede na sua aplicação. Para mais informações, consulte Ativar o Rastreio de Rede.

Note

O protocolo FTP envia informação, incluindo palavras-passe, em texto simples e não deve ser usado para transmitir informações sensíveis.

A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.Network.DownloadFile método.

Para	Veja
Descarregar um ficheiro	Como: Baixar um arquivo

Ver também

Aplica-se a

Comentários

Esta página foi útil?