WebClient.DownloadString Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.WebClient.dll

Stáhne požadovaný prostředek jako String. Prostředek ke stažení může být zadán jako obsahující String 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 prostředek String obsahující identifikátor URI.
DownloadString(Uri)	Stáhne požadovaný prostředek jako String. Prostředek ke stažení je zadaný jako Uri.

DownloadString(String)

Zdroj:

WebClient.cs

Stáhne požadovaný prostředek jako String. Prostředek ke stažení je určený jako prostředek 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 těchto DownloadStringAsync metod.

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

Tato metoda ke stažení prostředku FTP používá příkaz RETR. 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 rozhraní .NET Framework.

DownloadString(Uri)

Zdroj:

WebClient.cs

Stáhne požadovaný prostředek jako String. Prostředek ke stažení je zadaný 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 těchto DownloadStringAsync metod.

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

Tato metoda ke stažení prostředku FTP používá příkaz RETR. 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 rozhraní .NET Framework.