WebClient.DownloadString Methode

Definition

Lädt die angeforderte Ressource als String herunter.Downloads the requested resource as a String. Die herunterzuladende Ressource wird möglicherweise als String, der den URI enthält, oder als Uri angegeben.The resource to download may be specified as either String containing the URI or a Uri.

Überlädt

DownloadString(String)

Lädt die angeforderte Ressource als String herunter.Downloads the requested resource as a String. Die herunterzuladende Ressource wird als String angegeben, der den URI enthält.The resource to download is specified as a String containing the URI.

DownloadString(Uri)

Lädt die angeforderte Ressource als String herunter.Downloads the requested resource as a String. Die herunterzuladende Ressource ist als Uri angegeben.The resource to download is specified as a Uri.

DownloadString(String)

Lädt die angeforderte Ressource als String herunter.Downloads the requested resource as a String. Die herunterzuladende Ressource wird als String angegeben, der den URI enthält.The resource to download is specified as a String containing the 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

Parameter

address
String

Ein String mit dem herunterzuladenden URI.A String containing the URI to download.

Gibt zurück

Ein String mit der angeforderten Ressource.A String containing the requested resource.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress and address is invalid.

- oder --or- Fehler beim Herunterladen der Ressource.An error occurred while downloading the resource.

Die Methode wurde gleichzeitig für mehrere Threads aufgerufen.The method has been called simultaneously on multiple threads.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieser Methode veranschaulicht.The following code example demonstrates calling this method.

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

Diese Methode ruft die angegebene Ressource ab.This method retrieves the specified resource. Nachdem die Ressource heruntergeladen wurde, verwendet die-Methode die in der Encoding-Eigenschaft angegebene Codierung, um die Ressource in eine String zu konvertieren.After it downloads the resource, the method uses the encoding specified in the Encoding property to convert the resource to a String. Diese Methode blockiert beim Herunterladen der Ressource.This method blocks while downloading the resource. 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.To download a resource and continue executing while waiting for the server's response, use one of the DownloadStringAsync methods.

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.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString-Eigenschaft keine leere Zeichenfolge ist, wird Sie an address angefügt.If the QueryString property is not an empty string, it is appended to address.

Diese Methode verwendet den RETR-Befehl, um eine FTP-Ressource herunterzuladen.This method uses the RETR command to download an FTP resource. Bei einer HTTP-Ressource wird die Get-Methode verwendet.For an HTTP resource, the GET method is used.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

DownloadString(Uri)

Lädt die angeforderte Ressource als String herunter.Downloads the requested resource as a String. Die herunterzuladende Ressource ist als Uri angegeben.The resource to download is specified as a 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

Parameter

address
Uri

Ein Uri-Objekt, das den herunterzuladenden URI enthält.A Uri object containing the URI to download.

Gibt zurück

Ein String mit der angeforderten Ressource.A String containing the requested resource.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress and address is invalid.

- oder --or- Fehler beim Herunterladen der Ressource.An error occurred while downloading the resource.

Die Methode wurde gleichzeitig für mehrere Threads aufgerufen.The method has been called simultaneously on multiple threads.

Hinweise

Diese Methode ruft die angegebene Ressource ab.This method retrieves the specified resource. Nachdem die Ressource heruntergeladen wurde, verwendet die-Methode die in der Encoding-Eigenschaft angegebene Codierung, um die Ressource in eine String zu konvertieren.After it downloads the resource, the method uses the encoding specified in the Encoding property to convert the resource to a String. Diese Methode blockiert beim Herunterladen der Ressource.This method blocks while downloading the resource. 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.To download a resource and continue executing while waiting for the server's response, use one of the DownloadStringAsync methods.

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.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Wenn die QueryString-Eigenschaft keine leere Zeichenfolge ist, wird Sie an address angefügt.If the QueryString property is not an empty string, it is appended to address.

Diese Methode verwendet den RETR-Befehl, um eine FTP-Ressource herunterzuladen.This method uses the RETR command to download an FTP resource. Bei einer HTTP-Ressource wird die Get-Methode verwendet.For an HTTP resource, the GET method is used.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

Gilt für: