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í identifikátor String URI nebo Uri.

Přetížení

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

DownloadString(String)

Zdroj:

WebClient.cs

Stáhne požadovaný prostředek jako String. Prostředek ke stažení se zadává jako obsahující String 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

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

Návraty

String

Obsahující String 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ě ve 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 pomocí kódování zadaného Encoding ve vlastnosti převede prostředek 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 těchto 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 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 rozhraní .NET Framework.

DownloadString(Uri)

Zdroj:

WebClient.cs

Stáhne požadovaný prostředek jako String. Prostředek ke stažení se zadává 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

Obsahující String 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ě ve více vláknech.

Poznámky

Tato metoda načte zadaný prostředek. Po stažení prostředku metoda pomocí kódování zadaného Encoding ve vlastnosti převede prostředek 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 těchto 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 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 rozhraní .NET Framework.