Aracılığıyla paylaş


WebClient.DownloadFileAsync Yöntem

Tanım

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'sini.

fileName
String

Yerel bilgisayara yerleştirilecek dosyanın adı.

Özel durumlar

address parametresi null.

-veya-

fileName parametresi null.

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

Kaynak indirilirken bir hata oluştu.

fileName tarafından belirtilen yerel dosya başka bir iş parçacığı tarafından kullanılıyor.

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.

Bu yöntem, address parametresinde tarafından belirtilen URI'de kaynağı indirir. İndirme işlemi başarıyla tamamlandığında, indirilen dosya yerel bilgisayarda fileName olarak adlandırılır. 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 DownloadFileCompleted olayına bir olay işleyicisi ekleyin.

Bu yöntem, kaynak indirilirken çağıran iş parçacığını engellemez. İndirme işleminin tamamlanmasını beklerken engellemek için DownloadFile yöntemlerinden birini kullanın.

.NET Framework ve .NET Core 1.0'da, CancelAsync yöntemini çağırarak tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak bir URI belirtmiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, 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 FrameworkAğ İ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, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için, DownloadFile(Uri, String)tarafından oluşan ö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'sini.

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

address parametresi null.

-veya-

fileName parametresi null.

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

Kaynak indirilirken bir hata oluştu.

fileName tarafından belirtilen yerel dosya başka bir iş parçacığı tarafından kullanılıyor.

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.

Bu yöntem, address parametresinde tarafından belirtilen URI'de kaynağı indirir. İndirme işlemi başarıyla tamamlandığında, indirilen dosya yerel bilgisayarda fileName olarak adlandırılır. 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 DownloadFileCompleted olayına bir olay işleyicisi ekleyin.

Bu yöntem, kaynak indirilirken çağıran iş parçacığını engellemez. İndirme işleminin tamamlanmasını beklerken engellemek için DownloadFile yöntemlerinden birini kullanın.

.NET Framework ve .NET Core 1.0'da, CancelAsync yöntemini çağırarak tamamlanmamış zaman uyumsuz işlemleri iptal edebilirsiniz.

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak bir URI belirtmiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, 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 FrameworkAğ İ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