WebClient.DownloadString Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebClient.dll

Scarica la risorsa richiesta come String. La risorsa da scaricare può essere specificata come String contenente l'URI o un Uri.

Overload

DownloadString(String)	Scarica la risorsa richiesta come String. La risorsa da scaricare viene specificata come String contenente l'URI.
DownloadString(Uri)	Scarica la risorsa richiesta come String. La risorsa da scaricare viene specificata come Uri.

DownloadString(String)

Origine:

WebClient.cs

Scarica la risorsa richiesta come String. La risorsa da scaricare viene specificata come String contenente l'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

Parametri

address

String

String contenente l'URI da scaricare.

Restituisce

String

String contenente la risorsa richiesta.

Eccezioni

ArgumentNullException

Il parametro address è null.

WebException

L'URI formato dalla combinazione di BaseAddress e address non è valido.

-o-

Errore durante il download della risorsa.

NotSupportedException

Il metodo è stato chiamato simultaneamente su più thread.

Esempio

Nell'esempio di codice seguente viene illustrata la chiamata a questo metodo.

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

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Questo metodo recupera la risorsa specificata. Dopo aver scaricato la risorsa, il metodo usa la codifica specificata nella proprietà Encoding per convertire la risorsa in un String. Questo metodo si blocca durante il download della risorsa. Per scaricare una risorsa e continuare l'esecuzione durante l'attesa della risposta del server, usare uno dei metodi di DownloadStringAsync.

Se la proprietà BaseAddress non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la proprietà QueryString non è una stringa vuota, viene aggiunta a address.

Questo metodo usa il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo GET.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

DownloadString(Uri)

Origine:

WebClient.cs

Scarica la risorsa richiesta come String. La risorsa da scaricare viene specificata come 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

Parametri

address

Uri

Oggetto Uri contenente l'URI da scaricare.

Restituisce

String

String contenente la risorsa richiesta.

Eccezioni

ArgumentNullException

Il parametro address è null.

WebException

L'URI formato dalla combinazione di BaseAddress e address non è valido.

-o-

Errore durante il download della risorsa.

NotSupportedException

Il metodo è stato chiamato simultaneamente su più thread.

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Questo metodo recupera la risorsa specificata. Dopo aver scaricato la risorsa, il metodo usa la codifica specificata nella proprietà Encoding per convertire la risorsa in un String. Questo metodo si blocca durante il download della risorsa. Per scaricare una risorsa e continuare l'esecuzione durante l'attesa della risposta del server, usare uno dei metodi di DownloadStringAsync.

Se la proprietà BaseAddress non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la proprietà QueryString non è una stringa vuota, viene aggiunta a address.

Questo metodo usa il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo GET.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.