WebClient.DownloadStringTaskAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

Bir görev nesnesi kullanarak zaman uyumsuz işlem olarak belirtilen URI'den kaynağı String olarak indirir. Bu yöntemler çağıran iş parçacığını engellemez.

Aşırı Yüklemeler

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

DownloadStringTaskAsync(String)

Kaynak:

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);

member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>

Public Function DownloadStringTaskAsync (address As String) As Task(Of String)

Parametreler

address

String

İndirilmesi gereken kaynağın URI'si.

Döndürülenler

Task<String>

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

WebException

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

-veya-

Kaynak indirilirken bir hata oluştu.

Açıklamalar

Bu işlem engellemez. Veri kaynağı indirildikten sonra döndürülen Task<TResult> nesne tamamlanır. Kaynak, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak indirilir.

Bu yöntem, kaynağı indirdikten sonra özelliğinde Encoding belirtilen kodlamayı kullanarak kaynağı öğesine Stringdönüştürür. Bu yöntem, kaynağı indirirken çağıran iş parçacığını engellemez.

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

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

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.

DownloadStringTaskAsync(Uri)

Kaynak:

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);

member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>

Public Function DownloadStringTaskAsync (address As Uri) As Task(Of String)

Parametreler

address

Uri

İndirilmesi gereken kaynağın URI'si.

Döndürülenler

Task<String>

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

WebException

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

-veya-

Kaynak indirilirken bir hata oluştu.

Açıklamalar

Bu işlem engellemez. Veri kaynağı indirildikten sonra döndürülen Task<TResult> nesne tamamlanır. Kaynak, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak indirilir.

Bu yöntem, kaynağı indirdikten sonra özelliğinde Encoding belirtilen kodlamayı kullanarak kaynağı öğesine Stringdönüştürür. Bu yöntem, kaynağı indirirken çağıran iş parçacığını engellemez.

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

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

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.