WebClient.DownloadFileAsync 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 kaynağı zaman uyumsuz bir işlem olarak yerel bir dosyaya indirir. Bu yöntemler çağıran iş parçacığını engellemez.
Aşırı Yüklemeler
DownloadFileAsync(Uri, String) |
Belirtilen URI'ye sahip kaynağı yerel bir dosyaya indirir. Bu yöntem çağıran iş parçacığını engellemez. |
DownloadFileAsync(Uri, String, Object) |
Belirtilen URI'ye sahip kaynağı yerel bir dosyaya indirir. Bu yöntem çağıran iş parçacığını engellemez. |
DownloadFileAsync(Uri, String)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
Belirtilen URI'ye sahip kaynağı yerel bir dosyaya indirir. Bu yöntem çağıran iş parçacığını engellemez.
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName);
public void DownloadFileAsync (Uri address, string fileName);
member this.DownloadFileAsync : Uri * string -> unit
Public Sub DownloadFileAsync (address As Uri, fileName As String)
Parametreler
- address
- Uri
İndirilmesi gereken kaynağın URI'si.
- fileName
- String
Yerel bilgisayara yerleştirilecek dosyanın adı.
Özel durumlar
birleştirilerek BaseAddressaddress
oluşturulan URI geçersiz.
-veya-
Kaynak indirilirken bir hata oluştu.
tarafından fileName
belirtilen yerel dosya başka bir iş parçacığı tarafından kullanılıyor.
Açıklamalar
Bu yöntem, parametresinde tarafından belirtilen URI'deki address
kaynağı indirir. İndirme işlemi başarıyla tamamlandığında, indirilen dosya yerel bilgisayarda adlandırılır fileName
. Dosya, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak indirilir. Dosya kullanılabilir olduğunda bildirim almak için olaya bir olay işleyicisi DownloadFileCompleted ekleyin.
Bu yöntem, kaynak indirilirken çağıran iş parçacığını engellemez. İndirmenin tamamlanmasını beklerken engellemek için yöntemlerden birini DownloadFile kullanın.
.NET Framework ve .NET Core 1.0'da, yöntemini çağırarak CancelAsync tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.
BaseAddress Özellik boş bir dize ("") değilse ve address
mutlak bir URI belirtmiyorsa, 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 bir ASP.NET sayfasında kullanırken, sayfanın altında yürüttüğü hesabın yerel dosyaya erişim izni yoksa bir hata alırsınız.
Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan DownloadFile(Uri, String)özel durumlara bakın.
Şunlara uygulanır
DownloadFileAsync(Uri, String, Object)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
Belirtilen URI'ye sahip kaynağı yerel bir dosyaya indirir. Bu yöntem çağıran iş parçacığını engellemez.
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName, System::Object ^ userToken);
public void DownloadFileAsync (Uri address, string fileName, object? userToken);
public void DownloadFileAsync (Uri address, string fileName, object userToken);
member this.DownloadFileAsync : Uri * string * obj -> unit
Public Sub DownloadFileAsync (address As Uri, fileName As String, userToken As Object)
Parametreler
- address
- Uri
İndirilmesi gereken kaynağın URI'si.
- fileName
- String
Yerel bilgisayara yerleştirilecek dosyanın adı.
- userToken
- Object
Zaman uyumsuz işlem tamamlandığında çağrılan yönteme geçirilen kullanıcı tanımlı nesne.
Özel durumlar
birleştirilerek BaseAddressaddress
oluşturulan URI geçersiz.
-veya-
Kaynak indirilirken bir hata oluştu.
tarafından fileName
belirtilen yerel dosya başka bir iş parçacığı tarafından kullanılıyor.
Açıklamalar
Bu yöntem, parametresinde tarafından belirtilen URI'deki address
kaynağı indirir. İndirme işlemi başarıyla tamamlandığında, indirilen dosya yerel bilgisayarda adlandırılır fileName
. Dosya, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak indirilir. Dosya kullanılabilir olduğunda bildirim almak için olaya bir olay işleyicisi DownloadFileCompleted ekleyin.
Bu yöntem, kaynak indirilirken çağıran iş parçacığını engellemez. İndirmenin tamamlanmasını beklerken engellemek için yöntemlerden birini DownloadFile kullanın.
.NET Framework ve .NET Core 1.0'da, yöntemini çağırarak CancelAsync tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.
BaseAddress Özellik boş bir dize ("") değilse ve address
mutlak bir URI belirtmiyorsa, 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 bir ASP.NET sayfasında kullanırken, sayfanın altında yürüttüğü hesabın yerel 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