WebClient.DownloadStringAsync Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.WebClient.dll

veya Uriolarak String belirtilen kaynağı indirir. Bu yöntemler çağıran iş parçacığını engellemez.

Aşırı Yüklemeler

DownloadStringAsync(Uri)	olarak Uribelirtilen kaynağı indirir. Bu yöntem çağıran iş parçacığını engellemez.
DownloadStringAsync(Uri, Object)	Belirtilen dizeyi belirtilen kaynağa indirir. Bu yöntem çağıran iş parçacığını engellemez.

DownloadStringAsync(Uri)

Kaynak:

WebClient.cs

olarak Uribelirtilen kaynağı indirir. Bu yöntem çağıran iş parçacığını engellemez.

public:
 void DownloadStringAsync(Uri ^ address);

public void DownloadStringAsync (Uri address);

member this.DownloadStringAsync : Uri -> unit

Public Sub DownloadStringAsync (address As Uri)

Parametreler

address

Uri

Uri İndirilmesi gereken URI'yi içeren.

Özel durumlar

ArgumentNullException

address parametresidirnull.

WebException

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

-veya-

Kaynak indirilirken bir hata oluştu.

Açıklamalar

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. Sunucunun yanıtını beklerken bir kaynak indirmek ve engellemek için yöntemini kullanın DownloadString . İndirme işlemi tamamlandığında DownloadStringCompleted olay oluşturulur. Uygulamanızın bildirim almak için bu olayı işlemesi gerekir. İndirilen dize ö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.

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.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da 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 DownloadString(Uri)özel durumlara bakın.

DownloadStringAsync(Uri, Object)

Kaynak:

WebClient.cs

Belirtilen dizeyi belirtilen kaynağa indirir. Bu yöntem çağıran iş parçacığını engellemez.

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

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

member this.DownloadStringAsync : Uri * obj -> unit

Public Sub DownloadStringAsync (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öntemine geçirilen kullanıcı tanımlı nesne.

Özel durumlar

ArgumentNullException

address parametresidirnull.

WebException

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

-veya-

Kaynak indirilirken bir hata oluştu.

Açıklamalar

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. Sunucunun yanıtını beklerken bir kaynak indirmek ve engellemek için yöntemini kullanın DownloadString . İndirme işlemi tamamlandığında DownloadStringCompleted olay oluşturulur. Uygulamanızın bildirim almak için bu olayı işlemesi gerekir. İndirilen dize ö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.

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.

Not

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