WebClient.DownloadFile Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Belirtilen URI'ye sahip kaynağı yerel bir dosyaya indirir.
Aşırı Yüklemeler
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
- Kaynak:
- WebClient.cs
- 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
- fileName
- String
Verileri alacak yerel dosyanın adı.
Özel durumlar
birleştirilerek BaseAddressaddress
oluşturulan URI geçersiz.
-veya-
filename
veya Emptyşeklindedirnull
.
-veya-
Dosya yok.
-veya-
Veriler indirilirken bir hata oluştu.
yöntemi birden çok iş parçacığında aynı anda çağrıldı.
Açıklamalar
yöntemi parametresinde DownloadFile 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 bir 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 address
eklenir.
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
Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarı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şim izni yoksa bir hata alırsınız.
Şunlara uygulanır
DownloadFile(String, String)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- 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 alacak yerel dosyanın adı.
Özel durumlar
address
parametresidirnull
.
birleştirilerek BaseAddressaddress
oluşturulan URI geçersiz.
-veya-
filename
veya Emptyşeklindedirnull
.
-veya-
Dosya yok.
-veya- Veriler indirilirken bir hata oluştu.
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
yöntemi parametresinde DownloadFile 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 bir 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 address
eklenir.
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
Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarı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şim izni yoksa bir hata alırsınız.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin