WebClient.DownloadDataAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.WebClient.dll

Kaynağı, zaman uyumsuz bir Byte işlem olarak belirtilen URI'den bir dizi olarak indirir. Bu yöntemler çağıran iş parçacığını engellemez.

Aşırı Yüklemeler

Name	Description
DownloadDataAsync(Uri)	Kaynağı, zaman uyumsuz bir Byte işlem olarak belirtilen URI'den bir dizi olarak indirir.
DownloadDataAsync(Uri, Object)	Kaynağı, zaman uyumsuz bir Byte işlem olarak belirtilen URI'den bir dizi olarak indirir.

DownloadDataAsync(Uri)

Kaynak:

WebClient.cs

Kaynağı, zaman uyumsuz bir Byte işlem olarak belirtilen URI'den bir dizi olarak indirir.

public:
 void DownloadDataAsync(Uri ^ address);

public void DownloadDataAsync(Uri address);

member this.DownloadDataAsync : Uri -> unit

Public Sub DownloadDataAsync (address As Uri)

Parametreler

address

Uri

Uri İndirilmesi gereken URI'yi içeren.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

WebException

Birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

Kaynak indirilirken bir hata oluştu.

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, içinde belirtilen URI düzeniyle ilişkili protokol için varsayılan yöntemi kullanarak belirtilen addresskaynağı alır. Veriler, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak indirilir.

Bu yöntem, kaynağı indirirken çağıran iş parçacığını engellemez. Sunucunun yanıtını beklerken bir kaynak indirmek ve engellemek için yöntemlerden birini DownloadData kullanın. İndirme tamamlandığında olay DownloadDataCompleted oluşturulur. Uygulamanızın bildirim almak için bu olayı işlemesi gerekir. İndirilen veriler özelliğinde Result kullanılabilir.

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

Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET yöntemi kullanılır.

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak 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 addresseklenir.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

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ı hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından DownloadData(Uri)oluşan özel durumlara bakın.

DownloadDataAsync(Uri, Object)

Kaynak:

WebClient.cs

Kaynağı, zaman uyumsuz bir Byte işlem olarak belirtilen URI'den bir dizi olarak indirir.

public:
 void DownloadDataAsync(Uri ^ address, System::Object ^ userToken);

public void DownloadDataAsync(Uri address, object? userToken);

member this.DownloadDataAsync : Uri * obj -> unit

Public Sub DownloadDataAsync (address As Uri, userToken As Object)

Parametreler

address

Uri

Uri İndirilmesi gereken URI'yi içeren.

userToken

Object

Zaman uyumsuz işlem tamamlandığında çağrılan yönteme geçirilen kullanıcı tanımlı nesne.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

WebException

Birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

Kaynak indirilirken bir hata oluştu.

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, içinde belirtilen URI düzeniyle ilişkili protokol için varsayılan yöntemi kullanarak belirtilen addresskaynağı alır. Veriler, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak indirilir.

Bu yöntem, kaynağı indirirken çağıran iş parçacığını engellemez. Sunucunun yanıtını beklerken bir kaynak indirmek ve engellemek için yöntemlerden birini DownloadData kullanın. İndirme tamamlandığında olay DownloadDataCompleted oluşturulur. Uygulamanızın bildirim almak için bu olayı işlemesi gerekir. İndirilen veriler özelliğinde Result kullanılabilir.

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

Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET yöntemi kullanılır.

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak 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 addresseklenir.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.