WebClient.DownloadFile Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.WebClient.dll

Belirtilen URI'ye sahip kaynağı yerel bir dosyaya indirir.

Aşırı Yüklemeler

Name	Description
DownloadFile(Uri, String)	Belirtilen URI'ye sahip kaynağı yerel bir dosyaya indirir.
DownloadFile(String, String)	Belirtilen URI'ye sahip kaynağı yerel bir dosyaya indirir.

DownloadFile(Uri, String)

Kaynak:

WebClient.cs

Belirtilen URI'ye sahip kaynağı yerel bir dosyaya indirir.

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)

Parametreler

address

Uri

Veri indirilmesi için bir olarak Stringbelirtilen URI.

fileName

String

Verileri almak için yerel dosyanın adı.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

-veya-

fileName parametresi null'dir.

WebException

Birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

fileNameveya Emptyşeklindedirnull.

-veya-

Dosya yok.

-veya-

Veriler indirilirken bir hata oluştu.

NotSupportedException

yöntemi birden çok iş parçacığında aynı anda çağrıldı.

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

yöntemi, DownloadFile parametresinde tarafından belirtilen URI'den yerel dosya verilerine address indirir. Bu yöntem, kaynağı indirirken engeller. Bir kaynağı indirmek ve sunucunun yanıtını beklerken yürütmeye devam etmek için yöntemlerden birini DownloadFileAsync kullanın.

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için ile BaseAddress birleştirilen göreli bir URI olmalıdır. QueryString Özelliği boş bir dize değilse, öğesine addresseklenir.

Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET yöntemi kullanılır.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

Bu yöntemi ASP.NET sayfası gibi bir orta katman uygulamasında kullanırken, uygulamanın yürütüleceği hesabın dosyaya erişme izni yoksa bir hata alırsınız.

DownloadFile(String, String)

Kaynak:

WebClient.cs

Belirtilen URI'ye sahip kaynağı yerel bir dosyaya indirir.

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)

Parametreler

address

String

Verilerin indirildiği URI.

fileName

String

Verileri almak için yerel dosyanın adı.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

WebException

Birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

fileNameveya Emptyşeklindedirnull.

-veya-

Dosya yok.

-veya- Veriler indirilirken bir hata oluştu.

NotSupportedException

yöntemi birden çok iş parçacığında aynı anda çağrıldı.

Örnekler

Aşağıdaki kod örneği, dosyasından http://www.contoso.com yerel sabit sürücüye bir dosya indirir.

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

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

yöntemi, DownloadFile parametresinde tarafından belirtilen URI'den yerel dosya verilerine address indirir. Bu yöntem, kaynağı indirirken engeller. Bir kaynağı indirmek ve sunucunun yanıtını beklerken yürütmeye devam etmek için yöntemlerden birini DownloadFileAsync kullanın.

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için ile BaseAddress birleştirilen göreli bir URI olmalıdır. QueryString Özelliği boş bir dize değilse, öğesine addresseklenir.

Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET yöntemi kullanılır.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

Bu yöntemi ASP.NET sayfası gibi bir orta katman uygulamasında kullanırken, uygulamanın yürütüleceği hesabın dosyaya erişme izni yoksa bir hata alırsınız.