Network.DownloadFile Método

Referência

Definição

Namespace:: Microsoft.VisualBasic.Devices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Baixa o arquivo remoto especificado e o salva no local especificado.

Sobrecargas

DownloadFile(String, String)	Baixa o arquivo remoto especificado e o salva no local especificado.
DownloadFile(Uri, String)	Baixa o arquivo remoto especificado e o salva no local especificado.
DownloadFile(String, String, String, String)	Baixa o arquivo remoto especificado e o salva no local especificado.
DownloadFile(Uri, String, String, String)	Baixa o arquivo remoto especificado e o salva no local especificado.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)	Baixa o arquivo remoto especificado e o salva no local especificado.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)	Baixa o arquivo remoto especificado e o salva no local especificado.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)	Baixa o arquivo remoto especificado e o salva no local especificado.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)	Baixa o arquivo remoto especificado e o salva no local especificado.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Baixa o arquivo remoto especificado e o salva no local especificado.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Baixa o arquivo remoto especificado e o salva no local especificado.

DownloadFile(String, String)

Baixa o arquivo remoto especificado e o salva no local especificado.

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 arquivo a ser baixado, incluindo o nome do arquivo e endereço do host.

destinationFileName: String

Nome do arquivo e caminho do arquivo baixado.

Exceções

ArgumentException

destinationFileName termina com uma barra à direita.

TimeoutException

O servidor não responde durante o intervalo padrão (100 segundos).

SecurityException

O usuário não tem as permissões necessárias para executar uma operação de rede.

WebException

A solicitação foi negada pelo servidor Web de destino.

Exemplos

Este exemplo baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e o salva C:\Documents and Settings\All Users\Documentsem .

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 o salva em , especificando um intervalo de tempo limite de 500 milissegundos C:\Documents and Settings\All Users\Documents.

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

Comentários

DownloadFile gera informações de rastreamento quando você habilita 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 cabeçalhos HTTP opcionais. Alguns servidores poderão retornar 500 (Erro interno do servidor) se o cabeçalho do agente de usuário opcional estiver ausente. Para enviar cabeçalhos opcionais, você deve construir uma solicitação usando a WebClient classe .

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.Network.DownloadFile método .

Para	Consulte
Baixar um arquivo	Como: baixar um arquivo

Confira também

Aplica-se a

DownloadFile(Uri, String)

Baixa o arquivo remoto especificado e o salva no local especificado.

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 arquivo a ser baixado, incluindo o nome do arquivo e endereço do host.

destinationFileName: String

Nome do arquivo e caminho do arquivo baixado.

Exceções

ArgumentException

destinationFileName termina com uma barra à direita.

TimeoutException

O servidor não responde durante o intervalo padrão (100 segundos).

SecurityException

O usuário não tem as permissões necessárias para executar uma operação de rede.

WebException

A solicitação foi negada pelo servidor Web de destino.

Exemplos

Este exemplo baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e o salva C:\Documents and Settings\All Users\Documentsem .

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)

Comentários

Se o arquivo de destino já existir, o DownloadFile método não substituirá o arquivo existente. Você pode usar uma das outras sobrecargas do DownloadFile método para instruí-lo a substituir arquivos existentes, fornecer credenciais de usuário ou especificar um valor de tempo limite específico. DownloadFile gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Habilitando o rastreamento de rede.

Observação

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.Network.DownloadFile método .

Para	Consulte
Baixar um arquivo	Como: baixar um arquivo

Confira também

Aplica-se a

DownloadFile(String, String, String, String)

Baixa o arquivo remoto especificado e o salva no local especificado.

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 arquivo a ser baixado, incluindo o nome do arquivo e endereço do host.

destinationFileName: String

Nome do arquivo e caminho do arquivo baixado.

userName: String

Nome de usuário a ser autenticado. O padrão é uma cadeia de caracteres vazia, "".

password: String

Senha para autenticação. O padrão é uma cadeia de caracteres vazia, "".

Exceções

ArgumentException

destinationFileName termina com uma barra à direita.

TimeoutException

O servidor não responde durante o intervalo padrão (100 segundos).

SecurityException

O usuário não tem as permissões necessárias para executar uma operação de rede.

WebException

A solicitação foi negada pelo servidor Web de destino.

Exemplos

Este exemplo baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e o salva C:\Documents and Settings\All Users\Documentsem .

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)

Comentários

DownloadFile gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Habilitando o rastreamento de rede.

Observação

O protocolo FTP envia informações, incluindo senhas, em texto sem formatação e não deve ser usado para transmitir informações confidenciais.

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.Network.DownloadFile método .

Para	Consulte
Baixar um arquivo	Como: baixar um arquivo

Confira também

Aplica-se a

DownloadFile(Uri, String, String, String)

Baixa o arquivo remoto especificado e o salva no local especificado.

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 arquivo a ser baixado, incluindo o nome do arquivo e endereço do host.

destinationFileName: String

Nome do arquivo e caminho do arquivo baixado.

userName: String

Nome de usuário a ser autenticado. O padrão é uma cadeia de caracteres vazia, "".

password: String

Senha para autenticação. O padrão é uma cadeia de caracteres vazia, "".

Exceções

ArgumentException

destinationFileName termina com uma barra à direita.

TimeoutException

O servidor não responde durante o intervalo padrão (100 segundos).

SecurityException

O usuário não tem as permissões necessárias para executar uma operação de rede.

WebException

A solicitação foi negada pelo servidor Web de destino.

Exemplos

Este exemplo baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e o salva C:\Documents and Settings\All Users\Documentsem .

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)

Comentários

DownloadFile gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Habilitando o rastreamento de rede.

Observação

O protocolo FTP envia informações, incluindo senhas, em texto sem formatação e não deve ser usado para transmitir informações confidenciais.

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.Network.DownloadFile método .

Para	Consulte
Baixar um arquivo	Como: baixar um arquivo

Confira também

Aplica-se a

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

Baixa o arquivo remoto especificado e o salva no local especificado.

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 arquivo a ser baixado, incluindo o nome do arquivo e endereço do host.

destinationFileName: String

String. Nome do arquivo e caminho do arquivo baixado.

networkCredentials: ICredentials

ICredentials. Credenciais a serem fornecidas.

showUI: Boolean

True para exibir o andamento da operação; caso contrário, False. O padrão é False.

connectionTimeout: Int32

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

overwrite: Boolean

True para substituir arquivos existentes; caso contrário, False. O padrão é False.

Exceções

ArgumentException

destinationFileName termina com uma barra à direita.

IOException

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

TimeoutException

O servidor não responde dentro do connectionTimeout especificado.

SecurityException

O usuário não tem as permissões necessárias para executar uma operação de rede.

WebException

A solicitação foi negada pelo servidor Web de destino.

Exemplos

Este exemplo baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e o salva C:\Documents and Settings\All Users\Documentsem .

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)

Comentários

Se showUI estiver definido Truecomo , será exibida 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, portanto, não bloqueia a entrada do usuário para outras janelas no programa.

Se o servidor não responder dentro do especificado connectionTimeout, a operação será cancelada e uma exceção será gerada.

DownloadFile gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Habilitando o rastreamento de rede.

Observação

O protocolo FTP envia informações, incluindo senhas, em texto sem formatação e não deve ser usado para transmitir informações confidenciais.

A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.Network.DownloadFile método .

Para	Consulte
Baixar um arquivo	Como: baixar um arquivo

Confira também

Aplica-se a

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

Baixa o arquivo remoto especificado e o salva no local especificado.

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 arquivo a ser baixado, incluindo o nome do arquivo e endereço do host.

destinationFileName: String

Nome do arquivo e caminho do arquivo baixado.

userName: String

Nome de usuário a ser autenticado. O padrão é uma cadeia de caracteres vazia, "".

password: String

Senha para autenticação. O padrão é uma cadeia de caracteres vazia, "".

showUI: Boolean

True para exibir o andamento da operação; caso contrário, False. O padrão é False.

connectionTimeout: Int32

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

overwrite: Boolean

True para substituir arquivos existentes; caso contrário, False. O padrão é False.

Exceções

ArgumentException

destinationFileName termina com uma barra à direita.

IOException

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

TimeoutException

O servidor não responde dentro do connectionTimeout especificado.

SecurityException

O usuário não tem as permissões necessárias para executar uma operação de rede.

WebException

A solicitação foi negada pelo servidor Web de destino.

Exemplos

Este exemplo baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e o salva C:\Documents and Settings\All Users\Documentsem .

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)

Comentários

Se o servidor não responder dentro do especificado connectionTimeout, a operação será cancelada e uma exceção será gerada.

DownloadFile gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Habilitando o rastreamento de rede.

Observação

O protocolo FTP envia informações, incluindo senhas, em texto sem formatação e não deve ser usado para transmitir informações confidenciais.

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

Para	Consulte
Baixar um arquivo	Como: baixar um arquivo

Confira também

Aplica-se a

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

Baixa o arquivo remoto especificado e o salva no local especificado.

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 arquivo a ser baixado, incluindo o nome do arquivo e endereço do host.

destinationFileName: String

Nome do arquivo e caminho do arquivo baixado.

networkCredentials: ICredentials

Credenciais a serem fornecidas.

showUI: Boolean

True para exibir o andamento da operação; caso contrário, False. O padrão é False.

connectionTimeout: Int32

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

overwrite: Boolean

True para substituir arquivos existentes; caso contrário, False. O padrão é False.

onUserCancel: UICancelOption

Especifica o comportamento quando o usuário clica em Cancelar ou Não na caixa de diálogo mostrada como resultado de showUI definido como True. O padrão é ThrowException.

Exceções

ArgumentException

destinationFileName termina com uma barra à direita.

IOException

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

TimeoutException

O servidor não responde dentro do connectionTimeout especificado.

SecurityException

O usuário não tem as permissões necessárias para executar uma operação de rede.

WebException

A solicitação foi negada pelo servidor Web de destino.

Exemplos

Este exemplo baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e o salva C:\Documents and Settings\All Users\Documentsem .

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)

Comentários

Se showUI estiver definido como True, será exibida 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, portanto, não bloqueia a entrada do usuário para outras janelas no programa.

Se o servidor não responder dentro do especificado connectionTimeout, a operação será cancelada e uma exceção será gerada.

DownloadFile gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Habilitando o rastreamento de rede.

Observação

O protocolo FTP envia informações, incluindo senhas, em texto sem formatação e não deve ser usado para transmitir informações confidenciais.

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

Para	Consulte
Baixar um arquivo	Como: baixar um arquivo

Confira também

Aplica-se a

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

Baixa o arquivo remoto especificado e o salva no local especificado.

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 arquivo a ser baixado, incluindo o nome do arquivo e endereço do host.

destinationFileName: String

Nome do arquivo e caminho do arquivo baixado.

userName: String

Nome de usuário a ser autenticado. O padrão é uma cadeia de caracteres vazia, "".

password: String

Senha para autenticação. O padrão é uma cadeia de caracteres vazia, "".

showUI: Boolean

True para exibir o andamento da operação; caso contrário, False. O padrão é False.

connectionTimeout: Int32

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

overwrite: Boolean

True para substituir arquivos existentes; caso contrário, False. O padrão é False.

Exceções

ArgumentException

destinationFileName termina com uma barra à direita.

IOException

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

TimeoutException

O servidor não responde dentro do connectionTimeout especificado.

SecurityException

O usuário não tem as permissões necessárias para executar uma operação de rede.

WebException

A solicitação foi negada pelo servidor Web de destino.

Exemplos

Este exemplo baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e o salva C:\Documents and Settings\All Users\Documentsem .

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)

Comentários

Se o servidor não responder dentro do especificado connectionTimeout, a operação será cancelada e uma exceção será gerada.

DownloadFile gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Habilitando o rastreamento de rede.

Observação

O protocolo FTP envia informações, incluindo senhas, em texto sem formatação e não deve ser usado para transmitir informações confidenciais.

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

Para	Consulte
Baixar um arquivo	Como: baixar um arquivo

Confira também

Aplica-se a

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

Baixa o arquivo remoto especificado e o salva no local especificado.

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 arquivo a ser baixado, incluindo o nome do arquivo e endereço do host.

destinationFileName: String

Nome do arquivo e caminho do arquivo baixado.

userName: String

Nome de usuário a ser autenticado. O padrão é uma cadeia de caracteres vazia, "".

password: String

Senha para autenticação. O padrão é uma cadeia de caracteres vazia, "".

showUI: Boolean

True para exibir o andamento da operação; caso contrário, False. O padrão é False.

connectionTimeout: Int32

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

overwrite: Boolean

True para substituir arquivos existentes; caso contrário, False. O padrão é False.

onUserCancel: UICancelOption

Especifica o comportamento quando o usuário clica em Cancelar ou Não na caixa de diálogo mostrada como resultado de ShowUI definido como True. O padrão é ThrowException.

Exceções

ArgumentException

destinationFileName termina com uma barra à direita.

IOException

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

TimeoutException

O servidor não responde dentro do connectionTimeout especificado.

SecurityException

O usuário não tem as permissões necessárias para executar uma operação de rede.

WebException

A solicitação foi negada pelo servidor Web de destino.

Exemplos

Este exemplo baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e o salva C:\Documents and Settings\All Users\Documentsem .

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)

Comentários

Se o servidor não responder dentro do especificado connectionTimeout, a operação será cancelada e uma exceção será gerada.

DownloadFile gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Habilitando o rastreamento de rede.

Observação

O protocolo FTP envia informações, incluindo senhas, em texto sem formatação e não deve ser usado para transmitir informações confidenciais.

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

Para	Consulte
Baixar um arquivo	Como: baixar um arquivo

Confira também

Aplica-se a

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

Baixa o arquivo remoto especificado e o salva no local especificado.

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 arquivo a ser baixado, incluindo o nome do arquivo e endereço do host.

destinationFileName: String

Nome do arquivo e caminho do arquivo baixado.

userName: String

Nome de usuário a ser autenticado. O padrão é uma cadeia de caracteres vazia, "".

password: String

Senha para autenticação. O padrão é uma cadeia de caracteres vazia, "".

showUI: Boolean

True para exibir o andamento da operação; caso contrário, False. O padrão é False.

connectionTimeout: Int32

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

overwrite: Boolean

True para substituir arquivos existentes; caso contrário, False. O padrão é False.

onUserCancel: UICancelOption

Especifica o comportamento quando o usuário clica em Cancelar ou Não na caixa de diálogo mostrada como resultado de ShowUI definido como True. O padrão é ThrowException.

Exceções

ArgumentException

destinationFileName termina com uma barra à direita.

IOException

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

TimeoutException

O servidor não responde dentro do connectionTimeout especificado.

SecurityException

O usuário não tem as permissões necessárias para executar uma operação de rede.

WebException

A solicitação foi negada pelo servidor Web de destino.

Exemplos

Este exemplo baixa o arquivo WineList.txt de http://www.cohowinery.com/downloads e o salva C:\Documents and Settings\All Users\Documentsem .

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)

Comentários

Se o servidor não responder dentro do especificado connectionTimeout, a operação será cancelada e uma exceção será gerada.

DownloadFile gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Habilitando o rastreamento de rede.

Observação

O protocolo FTP envia informações, incluindo senhas, em texto sem formatação e não deve ser usado para transmitir informações confidenciais.

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

Para	Consulte
Baixar um arquivo	Como: baixar um arquivo

Confira também

Aplica-se a

Compartilhar via

Network.DownloadFile Método

Definição

Sobrecargas

DownloadFile(String, String)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

DownloadFile(Uri, String)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

DownloadFile(String, String, String, String)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

DownloadFile(Uri, String, String, String)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais