WebClient.DownloadStringAsync Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Net
Bütünleştirilmiş Kod:
System.Net.WebClient.dll
Bütünleştirilmiş Kod:
System.dll
Bütünleştirilmiş Kod:
netstandard.dll

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

Aşırı Yüklemeler

DownloadStringAsync(Uri)

Uriolarak belirtilen 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
Kaynak:
WebClient.cs
Kaynak:
WebClient.cs

Uriolarak belirtilen 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

İndirilmesi gereken URI'yi içeren bir Uri.

Özel durumlar

ArgumentNullException

address parametresi null.

WebException

BaseAddress ve address birleştirilerek 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.

Kaynak, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak indirilir.

Kaynağı indirdikten sonra, bu yöntem kaynağı Stringdönüştürmek için Encoding özelliğinde belirtilen kodlamayı kullanı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 DownloadString yöntemini kullanın. İndirme tamamlandığında, DownloadStringCompleted olayı oluşturulur. Uygulamanızın bildirim almak için bu olayı işlemesi gerekir. İndirilen dize Result özelliğinde kullanılabilir.

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

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak bir URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, 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 FrameworkAğ İzleme.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için, DownloadString(Uri)tarafından oluşan özel durumlara bakın.

Şunlara uygulanır

DownloadStringAsync(Uri, Object)

Kaynak:
WebClient.cs
Kaynak:
WebClient.cs
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);
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

İndirilmesi gereken URI'yi içeren bir Uri.

userToken
Object

Zaman uyumsuz işlem tamamlandığında çağrılan yönteme geçirilen kullanıcı tanımlı nesne.

Özel durumlar

ArgumentNullException

address parametresi null.

WebException

BaseAddress ve address birleştirilerek 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.

Kaynak, iş parçacığı havuzundan otomatik olarak ayrılan iş parçacığı kaynakları kullanılarak zaman uyumsuz olarak indirilir.

Kaynağı indirdikten sonra, bu yöntem kaynağı Stringdönüştürmek için Encoding özelliğinde belirtilen kodlamayı kullanı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 DownloadString yöntemini kullanın. İndirme tamamlandığında, DownloadStringCompleted olayı oluşturulur. Uygulamanızın bildirim almak için bu olayı işlemesi gerekir. İndirilen dize Result özelliğinde kullanılabilir.

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

BaseAddress özelliği boş bir dize ("") değilse ve address mutlak bir URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için BaseAddress ile birleştirilen göreli bir URI olmalıdır. QueryString özelliği boş bir dize değilse, 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 FrameworkAğ İzleme.

Şunlara uygulanır