WebClient.DownloadString Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Lädt die angeforderte Ressource als Stringherunter. Die herunterzuladende Ressource kann entweder als String mit dem URI oder als Uriangegeben werden.

Überlädt

DownloadString(String)	Lädt die angeforderte Ressource als Stringherunter. Die herunterzuladende Ressource wird als String mit dem URI angegeben.
DownloadString(Uri)	Lädt die angeforderte Ressource als Stringherunter. Die herunterzuladende Ressource wird als Uriangegeben.

DownloadString(String)

Quelle:

WebClient.cs

Lädt die angeforderte Ressource als Stringherunter. Die herunterzuladende Ressource wird als String mit dem URI angegeben.

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

Parameter

address

String

Eine String, die den herunterzuladenden URI enthält.

Gibt zurück

String

Eine String, die die angeforderte Ressource enthält.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

WebException

Der URI, der durch die Kombination von BaseAddress und address gebildet wird, ist ungültig.

-oder-

Fehler beim Herunterladen der Ressource.

NotSupportedException

Die Methode wurde für mehrere Threads gleichzeitig aufgerufen.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieser Methode veranschaulicht.

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

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Diese Methode ruft die angegebene Ressource ab. Nachdem die Ressource heruntergeladen wurde, verwendet die Methode die in der Encoding Eigenschaft angegebene Codierung, um die Ressource in eine Stringzu konvertieren. Diese Methode blockiert beim Herunterladen der Ressource. Wenn Sie eine Ressource herunterladen und die Ausführung fortsetzen möchten, während sie auf die Antwort des Servers warten, verwenden Sie eine der DownloadStringAsync Methoden.

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString keine leere Zeichenfolge ist, wird sie an addressangefügt.

Diese Methode verwendet den BEFEHL RETR, um eine FTP-Ressource herunterzuladen. Für eine HTTP-Ressource wird die GET-Methode verwendet.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

DownloadString(Uri)

Quelle:

WebClient.cs

Lädt die angeforderte Ressource als Stringherunter. Die herunterzuladende Ressource wird als Uriangegeben.

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

public string DownloadString (Uri address);

member this.DownloadString : Uri -> string

Public Function DownloadString (address As Uri) As String

Parameter

address

Uri

Ein Uri Objekt, das den herunterzuladenden URI enthält.

Gibt zurück

String

Eine String, die die angeforderte Ressource enthält.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

WebException

Der URI, der durch die Kombination von BaseAddress und address gebildet wird, ist ungültig.

-oder-

Fehler beim Herunterladen der Ressource.

NotSupportedException

Die Methode wurde für mehrere Threads gleichzeitig aufgerufen.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Diese Methode ruft die angegebene Ressource ab. Nachdem die Ressource heruntergeladen wurde, verwendet die Methode die in der Encoding Eigenschaft angegebene Codierung, um die Ressource in eine Stringzu konvertieren. Diese Methode blockiert beim Herunterladen der Ressource. Wenn Sie eine Ressource herunterladen und die Ausführung fortsetzen möchten, während sie auf die Antwort des Servers warten, verwenden Sie eine der DownloadStringAsync Methoden.

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die eigenschaft QueryString keine leere Zeichenfolge ist, wird sie an addressangefügt.

Diese Methode verwendet den BEFEHL RETR, um eine FTP-Ressource herunterzuladen. Für eine HTTP-Ressource wird die GET-Methode verwendet.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.