WebClient.DownloadString Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.WebClient.dll

İstenen kaynağı olarak Stringindirir. İndirilecek kaynak, URI'yi String veya bir Uriöğesini içeren olarak belirtilebilir.

Aşırı Yüklemeler

Name	Description
DownloadString(String)	İstenen kaynağı olarak Stringindirir. İndirilmesi gereken kaynak, URI'yi içeren bir String kaynak olarak belirtilir.
DownloadString(Uri)	İstenen kaynağı olarak Stringindirir. İndirilmesi gereken kaynak olarak Uribelirtilir.

DownloadString(String)

Kaynak:

WebClient.cs

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

public:
 System::String ^ DownloadString(System::String ^ address);

public string DownloadString(string address);

member this.DownloadString : string -> string

Public Function DownloadString (address As String) As String

Parametreler

address

String

String İndirilmesi gereken URI'yi içeren.

Döndürülenler

String

String İstenen kaynağı içeren.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

WebException

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

-veya-

Kaynak indirilirken bir hata oluştu.

NotSupportedException

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.

void DownloadString( String^ address )
{
   WebClient^ client = gcnew WebClient;
   String^ reply = client->DownloadString( address );
   Console::WriteLine( reply );
}

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

    Console.WriteLine(reply);
}

Public Shared Sub DownloadString(ByVal address As String)

    Dim client As WebClient = New WebClient()
    Dim reply As String = client.DownloadString(address)

    Console.WriteLine(reply)
End Sub

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

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için ile BaseAddress birleştirilen 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

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

DownloadString(Uri)

Kaynak:

WebClient.cs

İstenen kaynağı olarak Stringindirir. İndirilmesi gereken kaynak olarak Uribelirtilir.

public:
 System::String ^ DownloadString(Uri ^ address);

public string DownloadString(Uri address);

member this.DownloadString : Uri -> string

Public Function DownloadString (address As Uri) As String

Parametreler

address

Uri

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

Döndürülenler

String

String İstenen kaynağı içeren.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

WebException

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

-veya-

Kaynak indirilirken bir hata oluştu.

NotSupportedException

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

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için ile BaseAddress birleştirilen 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

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.