WebClient.DownloadString Yöntem

Tanım

İstenen kaynağı Stringolarak indirir. İndirilecek kaynak, URI'yi içeren String veya Uriolarak belirtilebilir.

Aşırı Yüklemeler

DownloadString(String)

İstenen kaynağı Stringolarak indirir. İndirilmesi gereken kaynak, URI'yi içeren bir String olarak belirtilir.

DownloadString(Uri)

İstenen kaynağı Stringolarak indirir. İndirilmesi gereken kaynak Uriolarak belirtilir.

DownloadString(String)

Kaynak:
WebClient.cs
Kaynak:
WebClient.cs
Kaynak:
WebClient.cs

İstenen kaynağı Stringolarak indirir. İndirilmesi gereken kaynak, URI'yi içeren bir String olarak belirtilir.

C#
public string DownloadString(string address);

Parametreler

address
String

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

Döndürülenler

İstenen kaynağı içeren bir String.

Özel durumlar

address parametresi null.

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

Kaynak indirilirken bir hata oluştu.

yöntemi birden çok iş parçacığında aynı anda çağrıldı.

Örnekler

Aşağıdaki kod örneğinde bu yöntemin çağrılması gösterilmektedir.

C#
public static void DownloadString(string address)
{
    WebClient client = new WebClient();
    string reply = client.DownloadString(address);

    Console.WriteLine(reply);
}

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 yöntem belirtilen kaynağı alır. Kaynağı indirdikten sonra yöntemi, kaynağı Stringdönüştürmek için Encoding özelliğinde belirtilen kodlamayı kullanır. Bu yöntem, kaynağı indirirken engeller. Bir kaynağı indirmek ve sunucunun yanıtını beklerken yürütmeye devam etmek için DownloadStringAsync yöntemlerinden birini kullanın.

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

.NET 10 ve diğer sürümler
Ürün Sürümler
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

DownloadString(Uri)

Kaynak:
WebClient.cs
Kaynak:
WebClient.cs
Kaynak:
WebClient.cs

İstenen kaynağı Stringolarak indirir. İndirilmesi gereken kaynak Uriolarak belirtilir.

C#
public string DownloadString(Uri address);

Parametreler

address
Uri

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

Döndürülenler

İstenen kaynağı içeren bir String.

Özel durumlar

address parametresi null.

BaseAddress ve address birleştirilerek oluşturulan URI geçersiz.

-veya-

Kaynak indirilirken bir hata oluştu.

yöntemi birden çok iş parçacığında aynı anda çağrıldı.

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 yöntem belirtilen kaynağı alır. Kaynağı indirdikten sonra yöntemi, kaynağı Stringdönüştürmek için Encoding özelliğinde belirtilen kodlamayı kullanır. Bu yöntem, kaynağı indirirken engeller. Bir kaynağı indirmek ve sunucunun yanıtını beklerken yürütmeye devam etmek için DownloadStringAsync yöntemlerinden birini kullanın.

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

.NET 10 ve diğer sürümler
Ürün Sürümler
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1