WebClient.DownloadString Metoda

  • Reference

Definice

Obor názvů:
System.Net
Sestavení:
System.Net.WebClient.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll

Stáhne požadovaný prostředek jako String. Prostředek ke stažení může být zadán jako String buď obsahující identifikátor URI, nebo Uri.

Přetížení

DownloadString(String)

Stáhne požadovaný prostředek jako String. Prostředek ke stažení je určen jako String obsahující identifikátor URI.
DownloadString(Uri)

Stáhne požadovaný prostředek jako String. Prostředek ke stažení je určen jako Uri.

DownloadString(String)

Stáhne požadovaný prostředek jako String. Prostředek ke stažení je určen jako String obsahující identifikátor URI.

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

Parametry

address
String

A String obsahující identifikátor URI ke stažení.

Návraty

String

A String obsahující požadovaný prostředek.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Při stahování prostředku došlo k chybě.

NotSupportedException

Metoda byla volána současně na více vláknech.

Příklady

Následující příklad kódu ukazuje volání této metody.

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

Poznámky

Tato metoda načte zadaný prostředek. Po stažení prostředku metoda použije kódování zadané ve Encoding vlastnosti k převodu prostředku na String. Tato metoda blokuje při stahování prostředku. Pokud chcete stáhnout prostředek a pokračovat v provádění při čekání na odpověď serveru, použijte jednu z DownloadStringAsync metod.

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který je kombinován s BaseAddress absolutním identifikátorem URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, je připojen k address.

Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v .NET Framework.

Platí pro

DownloadString(Uri)

Stáhne požadovaný prostředek jako String. Prostředek ke stažení je určen jako Uri.

public:
 System::String ^ DownloadString(Uri ^ address);
public string DownloadString (Uri address);
member this.DownloadString : Uri -> string
Public Function DownloadString (address As Uri) As String

Parametry

address
Uri

Objekt Uri obsahující identifikátor URI ke stažení.

Návraty

String

A String obsahující požadovaný prostředek.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress a address je neplatný.

-nebo-

Při stahování prostředku došlo k chybě.

NotSupportedException

Metoda byla volána současně na více vláknech.

Poznámky

Tato metoda načte zadaný prostředek. Po stažení prostředku metoda použije kódování zadané ve Encoding vlastnosti k převodu prostředku na String. Tato metoda blokuje při stahování prostředku. Pokud chcete stáhnout prostředek a pokračovat v provádění při čekání na odpověď serveru, použijte jednu z DownloadStringAsync metod.

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který je kombinován s BaseAddress absolutním identifikátorem URI požadovaných dat. QueryString Pokud vlastnost není prázdný řetězec, je připojen k address.

Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v .NET Framework.

Platí pro