WebClient.DownloadData WebClient.DownloadData WebClient.DownloadData WebClient.DownloadData Method

Definition

Lädt die Ressourcen als ein Byte Array von der angegebenen URI herunter.Downloads the resource as a Byte array from the URI specified.

Überlädt

DownloadData(String) DownloadData(String) DownloadData(String) DownloadData(String)

Lädt die Ressourcen als ein Byte Array von der angegebenen URI herunter.Downloads the resource as a Byte array from the URI specified.

DownloadData(Uri) DownloadData(Uri) DownloadData(Uri) DownloadData(Uri)

Lädt die Ressourcen als ein Byte Array von der angegebenen URI herunter.Downloads the resource as a Byte array from the URI specified.

DownloadData(String) DownloadData(String) DownloadData(String) DownloadData(String)

Lädt die Ressourcen als ein Byte Array von der angegebenen URI herunter.Downloads the resource as a Byte array from the URI specified.

public:
 cli::array <System::Byte> ^ DownloadData(System::String ^ address);
public byte[] DownloadData (string address);
member this.DownloadData : string -> byte[]
Public Function DownloadData (address As String) As Byte()

Parameter

address
String String String String

Der URI für den Download der Daten.The URI from which to download data.

Gibt zurück

Byte[]

Ein Byte-Array, das die heruntergeladene Ressource enthält.A Byte array containing the downloaded 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 von Daten.An error occurred while downloading data.

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

Beispiele

Im folgenden Codebeispiel wird Daten von einem Server angefordert, und die zurückgegebenen Daten angezeigt.The following code example requests data from a server and displays the data returned. Es wird vorausgesetzt, dass remoteUri einen gültigen URI für die angeforderten Daten enthält.It assumes that remoteUri contains a valid URI for the requested data.

Console::Write( "\nPlease enter a URI (e.g. http://www.contoso.com): " );
String^ remoteUri = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Download home page data.
Console::WriteLine( "Downloading {0}", remoteUri );
// Download the Web resource and save it into a data buffer.
array<Byte>^ myDataBuffer = myWebClient->DownloadData( remoteUri );

// Display the downloaded data.
String^ download = Encoding::ASCII->GetString( myDataBuffer );
Console::WriteLine( download );

Console::WriteLine( "Download successful." );
Console.Write("\nPlease enter a URI (for example, http://www.contoso.com): ");
string remoteUri = Console.ReadLine();

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Download home page data.
Console.WriteLine("Downloading " + remoteUri);                        
// Download the Web resource and save it into a data buffer.
byte[] myDataBuffer = myWebClient.DownloadData (remoteUri);

// Display the downloaded data.
string download = Encoding.ASCII.GetString(myDataBuffer);
Console.WriteLine(download);
                    
Console.WriteLine("Download successful.");

Console.Write(ControlChars.Cr + "Please enter a Url(for example, http://www.msn.com): ")
Dim remoteUrl As String = Console.ReadLine()
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Download the home page data.
Console.WriteLine(("Downloading " + remoteUrl))
' DownloadData() method takes a 'uriRemote.ToString()' and downloads the Web resource and saves it into a data buffer.
Dim myDatabuffer As Byte() = myWebClient.DownloadData(remoteUrl)

' Display the downloaded data.
Dim download As String = Encoding.ASCII.GetString(myDataBuffer)
Console.WriteLine(download)

Console.WriteLine("Download successful.")

Hinweise

Die DownloadData Methode lädt die Ressource herunter, mit dem vom angegebenen URI die address Parameter.The DownloadData method downloads the resource with the URI specified by the address parameter. Diese Methode wird beim Herunterladen der Ressource blockiert.This method blocks while downloading the resource. Um eine Ressource herunterzuladen, und weiter ausgeführt, während des Wartens auf die Antwort des Servers, gehen die DownloadDataAsync Methoden.To download a resource and continue executing while waiting for the server's response, use one of the DownloadDataAsync methods.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address enthält keinen absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress 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 dieser an angefügt address.If the QueryString property is not an empty string, it is appended to address.

Diese Methode verwendet den RETR-Befehl zum Herunterladen einer FTP-Ressource.This method uses the RETR command to download an FTP resource. Für eine 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 Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

DownloadData(Uri) DownloadData(Uri) DownloadData(Uri) DownloadData(Uri)

Lädt die Ressourcen als ein Byte Array von der angegebenen URI herunter.Downloads the resource as a Byte array from the URI specified.

public:
 cli::array <System::Byte> ^ DownloadData(Uri ^ address);
public byte[] DownloadData (Uri address);
member this.DownloadData : Uri -> byte[]
Public Function DownloadData (address As Uri) As Byte()

Parameter

address
Uri Uri Uri Uri

Der vom Uri-Objekt dargestellte URI für den Download von Daten.The URI represented by the Uri object, from which to download data.

Gibt zurück

Byte[]

Ein Byte-Array, das die heruntergeladene Ressource enthält.A Byte array containing the downloaded resource.

Ausnahmen

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

Hinweise

Die DownloadData Methode lädt die Ressource herunter, mit dem vom angegebenen URI die address Parameter.The DownloadData method downloads the resource with the URI specified by the address parameter. Diese Methode wird beim Herunterladen der Ressource blockiert.This method blocks while downloading the resource. Um eine Ressource herunterzuladen, und weiter ausgeführt, während des Wartens auf die Antwort des Servers, gehen die DownloadDataAsync Methoden.To download a resource and continue executing while waiting for the server's response, use one of the DownloadDataAsync methods.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address enthält keinen absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress 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 dieser an angefügt address.If the QueryString property is not an empty string, it is appended to address.

Diese Methode verwendet den RETR-Befehl zum Herunterladen einer FTP-Ressource.This method uses the RETR command to download an FTP resource. Für eine HTTP-Ressource wird die GET-Methode verwendet.For an HTTP resource, the GET method is used.

Beachten Sie dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die netzwerkablaufverfolgung in Ihrer Anwendung aktivieren.Note This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Gilt für: