WebClient.DownloadString Metódus

Definíció

Névtér:: System.Net

Szerelvények:: netstandard.dll, System.Net.WebClient.dll

Szerelvény:: System.Net.WebClient.dll

Szerelvény:: System.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Letölti a kért erőforrást String. A letölteni kívánt erőforrás URI-t vagy StringURI-t tartalmazóként Uri adható meg.

Túlterhelések

Name	Description
DownloadString(String)	Letölti a kért erőforrást String. A letöltendő erőforrás az URI-t tartalmazó erőforrásként String van megadva.
DownloadString(Uri)	Letölti a kért erőforrást String. A letölteni kívánt erőforrás a következőként Urivan megadva: .

DownloadString(String)

Forrás:: WebClient.cs

Forrás:: WebClient.cs

Forrás:: WebClient.cs

Forrás:: WebClient.cs

Forrás:: WebClient.cs

Letölti a kért erőforrást String. A letöltendő erőforrás az URI-t tartalmazó erőforrásként String van megadva.

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

Paraméterek

address: String

A String letöltendő URI-t tartalmazó fájl.

Válaszok

String

A String kért erőforrást tartalmazó.

Kivételek

ArgumentNullException

A address paraméter a következő null: .

WebException

A kombinálással BaseAddressaddress létrehozott URI érvénytelen.

-vagy-

Hiba történt az erőforrás letöltése közben.

NotSupportedException

A metódus egyszerre több szálon lett meghívva.

Példák

Az alábbi példakód bemutatja a metódus meghívását.

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

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Ez a metódus lekéri a megadott erőforrást. Miután letöltötte az erőforrást, a metódus a tulajdonságban Encoding megadott kódolással konvertálja az erőforrást egy String. Ez a metódus letiltja az erőforrás letöltését. Ha le szeretne tölteni egy erőforrást, és folytatni szeretné a végrehajtást a kiszolgáló válaszára való várakozás közben, használja az egyik metódust DownloadStringAsync .

Ha a BaseAddress tulajdonság nem üres sztring ("") és address nem tartalmaz abszolút URI-t, akkor relatív URI-nak kell lennie, address amely a BaseAddress kért adatok abszolút URI-jának létrehozásához van kombinálva. Ha a QueryString tulajdonság nem üres sztring, a program hozzáfűzi.address

Ez a metódus a RETR paranccsal tölt le egy FTP-erőforrást. HTTP-erőforrás esetén a GET metódust használja a rendszer.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

A következőre érvényes:

DownloadString(Uri)

Forrás:: WebClient.cs

Forrás:: WebClient.cs

Forrás:: WebClient.cs

Forrás:: WebClient.cs

Forrás:: WebClient.cs

Letölti a kért erőforrást String. A letölteni kívánt erőforrás a következőként Urivan megadva: .

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

public string DownloadString(Uri address);

member this.DownloadString : Uri -> string

Public Function DownloadString (address As Uri) As String