(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

WebClient.DownloadString-Methode (String)

Lädt die angeforderte Ressource als String herunter. Die herunterzuladende Ressource wird als String angegeben, der den URI enthält.

Namespace:  System.Net
Assembly:  System (in System.dll)

public string DownloadString(
	string address
)

Parameter

address
Typ: System.String
Ein String mit dem herunterzuladenden URI.

Rückgabewert

Typ: System.String
Ein String mit der angeforderten Ressource.

AusnahmeBedingung
ArgumentNullException

Der address-Parameter ist null.

WebException

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

Fehler beim Herunterladen der Ressource.

NotSupportedException

Die Methode wurde gleichzeitig für mehrere Threads aufgerufen.

Diese Methode ruft die angegebene Ressource ab. Nach dem Herunterladen der Ressource konvertiert diese Methode mit der in der Encoding-Eigenschaft angegebenen Codierung die Ressource in einen String. Diese Methode wird während des Herunterladens der Ressource blockiert. Verwenden Sie eine der DownloadStringAsync-Methoden, um eine Ressource herunterzuladen und Vorgänge während des Wartens auf die Serverantwort fortzusetzen.

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

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

HinweisHinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung.

Im folgenden Codebeispiel wird das Aufrufen dieser Methode veranschaulicht.


    public static void DownloadString (string address)
    {
        WebClient client = new WebClient ();
        string reply = client.DownloadString (address);

        Console.WriteLine (reply);
    }



.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2014 Microsoft