WebClient.DownloadDataTaskAsync 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.
Bir görev nesnesi kullanarak zaman uyumsuz işlem olarak belirtilen URI'den kaynağı Byte dizi olarak indirir. Bu yöntemler çağıran iş parçacığını engellemez.
Aşırı Yüklemeler
| DownloadDataTaskAsync(String) |
Bir görev nesnesi kullanarak zaman uyumsuz işlem olarak belirtilen URI'den kaynağı Byte dizi olarak indirir. |
| DownloadDataTaskAsync(Uri) |
Bir görev nesnesi kullanarak zaman uyumsuz işlem olarak belirtilen URI'den kaynağı Byte dizi olarak indirir. |
DownloadDataTaskAsync(String)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
Bir görev nesnesi kullanarak zaman uyumsuz işlem olarak belirtilen URI'den kaynağı Byte dizi olarak indirir.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>Public Function DownloadDataTaskAsync (address As String) As Task(Of Byte())Parametreler
- address
- String
İndirilmesi gereken kaynağın URI'si.
Döndürülenler
Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesindeki özelliği, indirilen kaynağı içeren bir Byte dizi döndürür.
- Öznitelikler
Özel durumlar
address parametresidirnull.
birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.
-veya-
Kaynak indirilirken bir hata oluştu.
Açıklamalar
Bu işlem engellenmez. Döndürülen Task<TResult> nesne, veri kaynağı indirildikten sonra tamamlanır.
Bu yöntem, parametresinde belirtilen URI şemasıyla 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.
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 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.
Aşağıdaki kod örneği bir sunucudan veri isteğinde bulunur ve döndürülen verileri görüntüler. İstenen veriler için geçerli bir URI içerdiğini varsayar remoteUri .
Şunlara uygulanır
DownloadDataTaskAsync(Uri)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
Bir görev nesnesi kullanarak zaman uyumsuz işlem olarak belirtilen URI'den kaynağı Byte dizi olarak indirir.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())Parametreler
- address
- Uri
İndirilmesi gereken kaynağın URI'si.
Döndürülenler
Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesindeki özelliği, indirilen kaynağı içeren bir Byte dizi döndürür.
- Öznitelikler
Özel durumlar
address parametresidirnull.
birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.
-veya-
Kaynak indirilirken bir hata oluştu.
Açıklamalar
Bu işlem engellenmez. Döndürülen Task<TResult> nesne, veri kaynağı indirildikten sonra tamamlanır.
Bu yöntem, parametresinde belirtilen URI şemasıyla 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.
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 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.
Ş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