Network.DownloadFile Método

  • Referência

Definição

Namespace:
Microsoft.VisualBasic.Devices
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.dll

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

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

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")

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

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

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(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")

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

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 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

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 .

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")

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

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 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

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 .

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")

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

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 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 .

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")

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

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 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 .

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")

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

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 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 .

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")

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

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 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 .

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")

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

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 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 .

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")

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

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 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 .

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