WebClient.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 recurso com o URI especificado para um arquivo local.
Sobrecargas
DownloadFile(Uri, String) |
Baixa o recurso com o URI especificado para um arquivo local. |
DownloadFile(String, String) |
Baixa o recurso com o URI especificado para um arquivo local. |
DownloadFile(Uri, String)
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Baixa o recurso com o URI especificado para um arquivo local.
public:
void DownloadFile(Uri ^ address, System::String ^ fileName);
public void DownloadFile (Uri address, string fileName);
member this.DownloadFile : Uri * string -> unit
Public Sub DownloadFile (address As Uri, fileName As String)
Parâmetros
- fileName
- String
O nome do arquivo local que deve receber os dados.
Exceções
O URI formado pela combinação de BaseAddress e address
é inválido.
- ou -
filename
é null
ou Empty.
- ou -
O arquivo não existe.
- ou -
Ocorreu um erro ao baixar os dados.
O método foi chamado simultaneamente em vários threads.
Comentários
O DownloadFile método baixa para dados de arquivo local do URI especificado pelo no address
parâmetro . Esse método bloqueia durante o download do recurso. Para baixar um recurso e continuar a execução enquanto aguarda a resposta do servidor, use um dos DownloadFileAsync métodos.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address
não contiver um URI absoluto, address
deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address
.
Esse método usa o comando RETR para baixar um recurso FTP. Para um recurso HTTP, o método GET é usado.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.
Ao usar esse método em um aplicativo de camada intermediária, como uma página ASP.NET, você receberá um erro se a conta na qual o aplicativo é executado não tiver permissão para acessar o arquivo.
Aplica-se a
DownloadFile(String, String)
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
- Origem:
- WebClient.cs
Baixa o recurso com o URI especificado para um arquivo local.
public:
void DownloadFile(System::String ^ address, System::String ^ fileName);
public void DownloadFile (string address, string fileName);
member this.DownloadFile : string * string -> unit
Public Sub DownloadFile (address As String, fileName As String)
Parâmetros
- address
- String
O URI do qual os dados serão baixados.
- fileName
- String
O nome do arquivo local que deve receber os dados.
Exceções
O parâmetro address
é null
.
O URI formado pela combinação de BaseAddress e address
é inválido.
- ou -
filename
é null
ou Empty.
- ou -
O arquivo não existe.
-ou- Erro ao baixar os dados.
O método foi chamado simultaneamente em vários threads.
Exemplos
O exemplo de código a seguir baixa um arquivo de http://www.contoso.com para o disco rígido local.
String^ remoteUri = "http://www.contoso.com/library/homepage/images/";
String^ fileName = "ms-banner.gif", ^myStringWebResource = nullptr;
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Concatenate the domain with the Web resource filename.
myStringWebResource = String::Concat( remoteUri, fileName );
Console::WriteLine( "Downloading File \"{0}\" from \"{1}\" .......\n\n", fileName, myStringWebResource );
// Download the Web resource and save it into the current filesystem folder.
myWebClient->DownloadFile( myStringWebResource, fileName );
Console::WriteLine( "Successfully Downloaded File \"{0}\" from \"{1}\"", fileName, myStringWebResource );
Console::WriteLine( "\nDownloaded file saved in the following file system folder:\n\t {0}", Application::StartupPath );
string remoteUri = "http://www.contoso.com/library/homepage/images/";
string fileName = "ms-banner.gif", myStringWebResource = null;
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Concatenate the domain with the Web resource filename.
myStringWebResource = remoteUri + fileName;
Console.WriteLine("Downloading File \"{0}\" from \"{1}\" .......\n\n", fileName, myStringWebResource);
// Download the Web resource and save it into the current filesystem folder.
myWebClient.DownloadFile(myStringWebResource,fileName);
Console.WriteLine("Successfully Downloaded File \"{0}\" from \"{1}\"", fileName, myStringWebResource);
Console.WriteLine("\nDownloaded file saved in the following file system folder:\n\t" + Application.StartupPath);
Dim remoteUri As String = "http://www.contoso.com/library/homepage/images/"
Dim fileName As String = "ms-banner.gif"
Dim myStringWebResource As String = Nothing
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Concatenate the domain with the Web resource filename. Because DownloadFile
'requires a fully qualified resource name, concatenate the domain with the Web resource file name.
myStringWebResource = remoteUri + fileName
Console.WriteLine("Downloading File ""{0}"" from ""{1}"" ......." + ControlChars.Cr + ControlChars.Cr, fileName, myStringWebResource)
' The DownloadFile() method downloads the Web resource and saves it into the current file-system folder.
myWebClient.DownloadFile(myStringWebResource, fileName)
Console.WriteLine("Successfully Downloaded file ""{0}"" from ""{1}""", fileName, myStringWebResource)
Console.WriteLine((ControlChars.Cr + "Downloaded file saved in the following file system folder:" + ControlChars.Cr + ControlChars.Tab + Application.StartupPath))
Comentários
O DownloadFile método baixa para dados de arquivo local do URI especificado pelo no address
parâmetro . Esse método bloqueia durante o download do recurso. Para baixar um recurso e continuar a execução enquanto aguarda a resposta do servidor, use um dos DownloadFileAsync métodos.
Se a BaseAddress propriedade não for uma cadeia de caracteres vazia ("") e address
não contiver um URI absoluto, address
deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia de caracteres vazia, ela será acrescentada a address
.
Esse método usa o comando RETR para baixar um recurso FTP. Para um recurso HTTP, o método GET é usado.
Observação
Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.
Ao usar esse método em um aplicativo de camada intermediária, como uma página ASP.NET, você receberá um erro se a conta na qual o aplicativo é executado não tiver permissão para acessar o arquivo.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
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, consulteEnviar e exibir comentários de