Aracılığıyla paylaş

WebClient.DownloadString 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

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

Aşırı Yüklemeler

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

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ılır.

Ö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

Bu yöntem belirtilen kaynağı alır. Yöntemi, kaynağı indirdikten sonra özelliğinde Encoding belirtilen kodlamayı kullanarak kaynağı öğesine Stringdönüştürü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 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.

Şunlara uygulanır

DownloadString(Uri)

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

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ılır.

Açıklamalar

Bu yöntem belirtilen kaynağı alır. Yöntemi, kaynağı indirdikten sonra özelliğinde Encoding belirtilen kodlamayı kullanarak kaynağı öğesine Stringdönüştürü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 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.

Şunlara uygulanır