Método My.Computer.rede.DownloadFile

O download do arquivo remoto especificado e o salva no local especificado.

' Usage
My.Computer.Network.DownloadFile(address ,destinationFileName)
My.Computer.Network.DownloadFile(address ,destinationFileName)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite ,onUserCancel)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite ,onUserCancel)
My.Computer.Network.DownloadFile(address ,destinationFileName ,networkCredentials ,showUI ,connectionTimeout ,overwrite)
My.Computer.Network.DownloadFile(address ,destinationFileName ,networkCredentials ,showUI ,connectionTimeout ,overwrite ,onUserCancel)
' Declaration
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean, _
   ByVal onUserCancel As UICancelOption _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean, _
   ByVal onUserCancel As UICancelOption _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal networkCredentials As System.Net.ICredentials, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal networkCredentials As System.Net.ICredentials, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean, _
   ByVal onUserCancel As UICancelOption _
)

Parâmetros

• address
  String ou Uri. Caminho do arquivo para fazer o baixar, incluindo o arquivo de nome e o host o endereço.Obrigatório.

• destinationFileName
  String.Nome de arquivo e caminho do arquivo baixado.Obrigatório.

• userName
  String.Nome de usuário para autenticar.Padrão é uma seqüência vazia, "".

• password
  StringSenha para autenticação.Padrão é uma seqüência vazia, "".

• showUI
  Boolean.Especifica se exibe o progresso da operação.O padrão é False.

• connectionTimeout
  Int32.Intervalo de tempo limite, em milissegundos.Padrão é 100 segundos.

• overwrite
  Boolean.Especifica se deve substituir arquivos existentes.O padrão é False.

• onUserCancel
  UICancelOption.Especifica o comportamento quando o usuário clica em Cancelar or Não na caixa de diálogo mostrada sistema autônomo resultado de ShowUI definido sistema autônomo True. O padrão é ThrowException.

• networkCredentials
  ICredentials.Credenciais a serem fornecidos.

Exceções

As seguintes condições podem causar uma exceção:

• O nome da unidade inválido (ArgumentException).

• destinationFileName termina com uma (barra / à direitaArgumentException).

• overwrite é definido como False e o arquivo de destino já existe)IOException).

• O servidor não responde dentro do connectionTimeout especificado (TimeoutException).

• A autenticação falha (SecurityException).

• O usuário não possui as permissões necessárias (SecurityException).

• A solicitação é negada pelo site (WebException).

Comentários

If showUI é conjunto para True, uma caixa de diálogo é exibida informando o andamento da operação; a caixa de diálogo contém uma Cancelar botão que pode ser usado para cancelar a operação.A caixa de diálogo não é modal e, portanto, não bloqueia a entrada do usuário para outras janelas do programa.

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

DownloadFile tem como saída o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.Para obter mais informações, consulte Habilitando o rastreamento de rede.

Observação:
O DownloadFile método não envia opcionais cabeçalhos HTTP. Alguns servidores podem retornar 500 (erro interno do servidor) se o cabeçalho de agente do usuário opcional estiver faltando.Para enviar cabeçalhos opcionais, você precisa construir uma solicitação usando o WebClient classe. Para obter mais informações, consulte Operações de rede no .NET Framework com Visual Basic.

Observação de segurança:
O protocolo FTP envia informações, incluindo senhas, em texto sem-formatação e não deve ser usado para transmissão de informações sigilosas.

Tarefas

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

Para	Consulte
Baixar um arquivo	Como: Baixar um arquivo no Visual Basic

Exemplo

Este exemplo baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e a salvará no 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 baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e a salvará no C:\Documents and Settings\All Users\Documents, especificando um intervalo de tempo limite de 500 milissegundos.

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

Requisitos

Namespace:Microsoft.VisualBasic.Devices

Classe:Network

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim

Permissões

As seguintes permissões podem ser necessárias:

Permissão	Descrição
FileIOPermission	Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.
UIPermission	Controla as permissões relacionadas às interfaces com o usuário e área de transferência.Enumeração associada: AllWindows.
WebPermission	Controla os direitos de acesso aos recursos de internet HTTP.Enumeração associada: Unrestricted.

Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.

Consulte também

Tarefas

Como: Baixar um arquivo no Visual Basic

Como: Determinar se um computador remoto está disponível no Visual Basic

Como: Analisar Arquivo Paths in Visual Basic

Referência

Objeto My.Computer.Network

System.Uri

System.Net.ICredentials

Network.DownloadFile