WebClient.DownloadFile Metod

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)

Parametrar

Undantag

Kommentarer

Metoden DownloadFile laddar ned till en lokal fildata från den URI som anges av i parametern address . Den här metoden blockerar när resursen laddas ned. Om du vill ladda ned en resurs och fortsätta köra i väntan på serverns svar använder du någon av DownloadFileAsync metoderna.

Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .

Den här metoden använder RETR-kommandot för att ladda ned en FTP-resurs. För en HTTP-resurs används GET-metoden.

När du använder den här metoden i ett mellannivåprogram, till exempel en ASP.NET sida, får du ett felmeddelande om kontot som programmet körs under inte har behörighet att komma åt filen.

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)

Parametrar

Undantag

Exempel

I följande kodexempel laddas en fil ned från http://www.contoso.com till den lokala hårddisken.

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

Kommentarer

Metoden DownloadFile laddar ned till en lokal fildata från den URI som anges av i parametern address . Den här metoden blockerar när resursen laddas ned. Om du vill ladda ned en resurs och fortsätta köra i väntan på serverns svar använder du någon av DownloadFileAsync metoderna.

Om egenskapen BaseAddress inte är en tom sträng ("") och address inte innehåller en absolut URI måste address den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för de begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .

Den här metoden använder RETR-kommandot för att ladda ned en FTP-resurs. För en HTTP-resurs används GET-metoden.

När du använder den här metoden i ett mellannivåprogram, till exempel en ASP.NET sida, får du ett felmeddelande om kontot som programmet körs under inte har behörighet att komma åt filen.