WebClient.DownloadString Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Net
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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

Overload

DownloadString(String)

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

Scarica la risorsa richiesta come oggetto String. La risorsa da scaricare viene specificata come classe Uri.

DownloadString(String)

Origine:
WebClient.cs
Origine:
WebClient.cs
Origine:
WebClient.cs

Scarica la risorsa richiesta come oggetto 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

Classe String contenente l'URI da scaricare.

Restituisce

String

String contenente la risorsa richiesta.

Eccezioni

ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI ottenuto combinando BaseAddress e address non è valido.

-oppure-

Si è verificato un errore durante il download della risorsa.

NotSupportedException

Questo 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

Questo metodo recupera la risorsa specificata. Dopo aver scaricato la risorsa, il metodo usa la codifica specificata nella Encoding proprietà per convertire la risorsa in un oggetto 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 DownloadStringAsync metodi .

Se la BaseAddress proprietà 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 QueryString proprietà 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 genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Si applica a

DownloadString(Uri)

Origine:
WebClient.cs
Origine:
WebClient.cs
Origine:
WebClient.cs

Scarica la risorsa richiesta come oggetto String. La risorsa da scaricare viene specificata come classe 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 valore del parametro address è null.

WebException

L'URI ottenuto combinando BaseAddress e address non è valido.

-oppure-

Si è verificato un errore durante il download della risorsa.

NotSupportedException

Questo metodo è stato chiamato simultaneamente su più thread.

Commenti

Questo metodo recupera la risorsa specificata. Dopo aver scaricato la risorsa, il metodo usa la codifica specificata nella Encoding proprietà per convertire la risorsa in un oggetto 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 DownloadStringAsync metodi .

Se la BaseAddress proprietà 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 QueryString proprietà 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 genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Si applica a