WebClient.DownloadDataTaskAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.WebClient.dll

Bir görev nesnesi kullanarak 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

Name	Description
DownloadDataTaskAsync(String)	Bir görev nesnesi kullanarak zaman uyumsuz işlem Byte olarak belirtilen URI'den kaynağı dizi olarak indirir.
DownloadDataTaskAsync(Uri)	Bir görev nesnesi kullanarak zaman uyumsuz işlem Byte olarak belirtilen URI'den kaynağı dizi olarak indirir.

DownloadDataTaskAsync(String)

Kaynak:

WebClient.cs

Bir görev nesnesi kullanarak zaman uyumsuz işlem Byte olarak belirtilen URI'den kaynağı 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);

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

Döndürülenler

Task<Byte[]>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesinde özelliği, indirilen kaynağı içeren bir Byte dizi döndürür.

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

Bu yöntem, parametresinde 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.

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.

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 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ği varsayılır remoteUri .

DownloadDataTaskAsync(Uri)

Kaynak:

WebClient.cs

Bir görev nesnesi kullanarak zaman uyumsuz işlem Byte olarak belirtilen URI'den kaynağı dizi olarak indirir.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(Uri address);

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

Döndürülenler

Task<Byte[]>

Zaman uyumsuz işlemi temsil eden görev nesnesi. Result Görev nesnesinde özelliği, indirilen kaynağı içeren bir Byte dizi döndürür.

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

Bu yöntem, parametresinde 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.

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.

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 Framework'te Ağ İzleme.