WebClient.DownloadStringTaskAsync 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ğı 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
- Kaynak:
- WebClient.cs
- 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);
member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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'sini.
Döndürülenler
Zaman uyumsuz işlemi temsil eden görev nesnesi. Görev nesnesinde Result özelliği, indirilen kaynağı içeren bir Byte dizisi döndürür.
- Öznitelikler
Özel durumlar
address
parametresi null
.
BaseAddress ve address
birleştirilerek oluşturulan URI geçersiz.
-veya-
Kaynak indirilirken bir hata oluştu.
Açıklamalar
Dikkat
WebRequest
, HttpWebRequest
, ServicePoint
ve 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> nesnesi, veri kaynağı indirildikten sonra tamamlanır. 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.
.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, address
eklenir.
Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET yöntemi kullanılır.
Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework
Şunlara uygulanır
DownloadStringTaskAsync(Uri)
- Kaynak:
- WebClient.cs
- Kaynak:
- WebClient.cs
- 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);
member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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'sini.
Döndürülenler
Zaman uyumsuz işlemi temsil eden görev nesnesi. Görev nesnesinde Result özelliği, indirilen kaynağı içeren bir Byte dizisi döndürür.
- Öznitelikler
Özel durumlar
address
parametresi null
.
BaseAddress ve address
birleştirilerek oluşturulan URI geçersiz.
-veya-
Kaynak indirilirken bir hata oluştu.
Açıklamalar
Dikkat
WebRequest
, HttpWebRequest
, ServicePoint
ve 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> nesnesi, veri kaynağı indirildikten sonra tamamlanır. 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.
.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, address
eklenir.
Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET yöntemi kullanılır.
Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Ç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.Gönderin ve geri bildirimi görüntüleyin