Network.DownloadFile Método
Definição
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 -> unitPublic 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
destinationFileName termina com uma barra à direita.
O servidor não responde durante o intervalo padrão (100 segundos).
O usuário não tem as permissões necessárias para executar uma operação de rede.
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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Como baixar um arquivo no Visual Basic
- Como analisar demarcadores de arquivo no Visual Basic
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 -> unitPublic 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
destinationFileName termina com uma barra à direita.
O servidor não responde durante o intervalo padrão (100 segundos).
O usuário não tem as permissões necessárias para executar uma operação de rede.
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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Como baixar um arquivo no Visual Basic
- Como analisar demarcadores de arquivo no Visual Basic
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 -> unitPublic 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
destinationFileName termina com uma barra à direita.
O servidor não responde durante o intervalo padrão (100 segundos).
O usuário não tem as permissões necessárias para executar uma operação de rede.
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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Como baixar um arquivo no Visual Basic
- Como analisar demarcadores de arquivo no Visual Basic
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 -> unitPublic 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
destinationFileName termina com uma barra à direita.
O servidor não responde durante o intervalo padrão (100 segundos).
O usuário não tem as permissões necessárias para executar uma operação de rede.
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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Como baixar um arquivo no Visual Basic
- Como analisar demarcadores de arquivo no Visual Basic
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 -> unitPublic 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
destinationFileName termina com uma barra à direita.
overwrite é definido como False e o arquivo de destino já existe.
O servidor não responde dentro do connectionTimeout especificado.
O usuário não tem as permissões necessárias para executar uma operação de rede.
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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Como baixar um arquivo no Visual Basic
- Como analisar demarcadores de arquivo no Visual Basic
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 -> unitPublic 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
destinationFileName termina com uma barra à direita.
overwrite é definido como False e o arquivo de destino já existe.
O servidor não responde dentro do connectionTimeout especificado.
O usuário não tem as permissões necessárias para executar uma operação de rede.
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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Como baixar um arquivo no Visual Basic
- Como analisar demarcadores de arquivo no Visual Basic
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 -> unitPublic 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
destinationFileName termina com uma barra à direita.
overwrite é definido como False e o arquivo de destino já existe.
O servidor não responde dentro do connectionTimeout especificado.
O usuário não tem as permissões necessárias para executar uma operação de rede.
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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Como baixar um arquivo no Visual Basic
- Como analisar demarcadores de arquivo no Visual Basic
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 -> unitPublic 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
destinationFileName termina com uma barra à direita.
overwrite é definido como False e o arquivo de destino já existe.
O servidor não responde dentro do connectionTimeout especificado.
O usuário não tem as permissões necessárias para executar uma operação de rede.
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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Como baixar um arquivo no Visual Basic
- Como analisar demarcadores de arquivo no Visual Basic
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 -> unitPublic 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
destinationFileName termina com uma barra à direita.
overwrite é definido como False e o arquivo de destino já existe.
O servidor não responde dentro do connectionTimeout especificado.
O usuário não tem as permissões necessárias para executar uma operação de rede.
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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Como baixar um arquivo no Visual Basic
- Como analisar demarcadores de arquivo no Visual Basic
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 -> unitPublic 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
destinationFileName termina com uma barra à direita.
overwrite é definido como False e o arquivo de destino já existe.
O servidor não responde dentro do connectionTimeout especificado.
O usuário não tem as permissões necessárias para executar uma operação de rede.
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
- Uri
- ICredentials
- Objetos (Visual Basic)
- Como baixar um arquivo no Visual Basic
- Como analisar demarcadores de arquivo no Visual Basic
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de