WebClient.DownloadFileTaskAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

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

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

member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task

Public Function DownloadFileTaskAsync (address As String, fileName As String) As Task

Parametreler

address

String

İndirilmesi gereken kaynağın URI'sini.

fileName

String

Yerel bilgisayara yerleştirilecek dosyanın adı.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

fileName parametresi null.

WebException

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

-veya-

Kaynak indirilirken bir hata oluştu.

InvalidOperationException

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 işlem engellenmez. Döndürülen Task nesnesi, veri kaynağı indirildikten sonra tamamlanır.

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.

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

DownloadFileTaskAsync(Uri, String)

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

member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task

Public Function DownloadFileTaskAsync (address As Uri, fileName As String) As Task

Parametreler

address

Uri

İndirilmesi gereken kaynağın URI'sini.

fileName

String

Yerel bilgisayara yerleştirilecek dosyanın adı.

Döndürülenler

Task

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

ArgumentNullException

address parametresi null.

-veya-

fileName parametresi null.

WebException

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

-veya-

Kaynak indirilirken bir hata oluştu.

InvalidOperationException

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 işlem engellenmez. Döndürülen Task nesnesi, veri kaynağı indirildikten sonra tamamlanır.

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.

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