WebClient.DownloadFileTaskAsync 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ğı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak yerel bir dosyaya indirir. Bu yöntemler çağıran iş parçacığını engellemez.
Aşırı Yüklemeler
| DownloadFileTaskAsync(String, String) |
Belirtilen kaynağı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak yerel bir dosyaya indirir. |
| DownloadFileTaskAsync(Uri, String) |
Belirtilen kaynağı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak yerel bir dosyaya indirir. |
DownloadFileTaskAsync(String, String)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
Belirtilen kaynağı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak yerel bir dosyaya indirir.
public:
System::Threading::Tasks::Task ^ DownloadFileTaskAsync(System::String ^ address, System::String ^ fileName);public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.TaskPublic Function DownloadFileTaskAsync (address As String, fileName As String) As TaskParametreler
- address
- String
İndirilmesi gereken kaynağın URI'si.
- fileName
- String
Yerel bilgisayara yerleştirilecek dosyanın adı.
Döndürülenler
Zaman uyumsuz işlemi temsil eden görev nesnesi.
- Öznitelikler
Ö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 işlem engellenmez. Döndürülen Task nesne, veri kaynağı indirildikten sonra tamamlanır.
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.
.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 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
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
DownloadFileTaskAsync(Uri, String)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
Belirtilen kaynağı bir görev nesnesi kullanarak zaman uyumsuz bir işlem olarak yerel bir dosyaya indirir.
public:
System::Threading::Tasks::Task ^ DownloadFileTaskAsync(Uri ^ address, System::String ^ fileName);public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.TaskPublic Function DownloadFileTaskAsync (address As Uri, fileName As String) As TaskParametreler
- address
- Uri
İndirilmesi gereken kaynağın URI'si.
- fileName
- String
Yerel bilgisayara yerleştirilecek dosyanın adı.
Döndürülenler
Zaman uyumsuz işlemi temsil eden görev nesnesi.
- Öznitelikler
Ö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 işlem engellenmez. Döndürülen Task nesne, veri kaynağı indirildikten sonra tamamlanır.
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.
.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 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
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
Ç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. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin