WebClient.DownloadDataAsync 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.
Zaman uyumsuz işlem Byte olarak belirtilen URI'den kaynağı dizi olarak indirir. Bu yöntemler çağıran iş parçacığını engellemez.
Aşırı Yüklemeler
DownloadDataAsync(Uri) |
Zaman uyumsuz işlem Byte olarak belirtilen URI'den kaynağı dizi olarak indirir. |
DownloadDataAsync(Uri, Object) |
Zaman uyumsuz işlem Byte olarak belirtilen URI'den kaynağı dizi olarak indirir. |
DownloadDataAsync(Uri)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
Zaman uyumsuz işlem Byte olarak belirtilen URI'den kaynağı 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
Özel durumlar
address
parametresidirnull
.
birleştirilerek BaseAddressaddress
oluşturulan URI geçersiz.
-veya-
Kaynak indirilirken bir hata oluştu.
Açıklamalar
Bu yöntem, içinde belirtilen URI düzeniyle ilişkili protokol için varsayılan yöntemi kullanarak belirtilen address
kaynağı 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 kaynağı indirmek ve engellemek için yöntemlerden birini DownloadData kullanın. İndirme işlemi tamamlandığında DownloadDataCompleted olay 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 bir URI içermiyorsa, address
istenen verilerin mutlak URI'sini oluşturmak için ile birleştirilen BaseAddress göreli bir URI olmalıdır.
QueryString özelliği boş bir dize değilse, öğesine address
eklenir.
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öntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan DownloadData(Uri)özel durumlara bakın.
Şunlara uygulanır
DownloadDataAsync(Uri, Object)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
Zaman uyumsuz işlem Byte olarak belirtilen URI'den kaynağı dizi olarak indirir.
public:
void DownloadDataAsync(Uri ^ address, System::Object ^ userToken);
public void DownloadDataAsync (Uri address, 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
- userToken
- Object
Zaman uyumsuz işlem tamamlandığında çağrılan yöntemine geçirilen kullanıcı tanımlı nesne.
Özel durumlar
address
parametresidirnull
.
birleştirilerek BaseAddressaddress
oluşturulan URI geçersiz.
-veya-
Kaynak indirilirken bir hata oluştu.
Açıklamalar
Bu yöntem, içinde belirtilen URI düzeniyle ilişkili protokol için varsayılan yöntemi kullanarak belirtilen address
kaynağı 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 kaynağı indirmek ve engellemek için yöntemlerden birini DownloadData kullanın. İndirme işlemi tamamlandığında DownloadDataCompleted olay 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 bir URI içermiyorsa, address
istenen verilerin mutlak URI'sini oluşturmak için ile birleştirilen BaseAddress göreli bir URI olmalıdır.
QueryString özelliği boş bir dize değilse, öğesine address
eklenir.
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.
Ş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