WebClient.DownloadData Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Lädt die Ressource als Byte Array aus dem angegebenen URI herunter.

Überlädt

DownloadData(String)	Lädt die Ressource als Byte Array aus dem angegebenen URI herunter.
DownloadData(Uri)	Lädt die Ressource als Byte Array aus dem angegebenen URI herunter.

DownloadData(String)

Quelle:

WebClient.cs

Lädt die Ressource als Byte Array aus dem angegebenen URI herunter.

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

Der URI, aus dem Daten heruntergeladen werden sollen.

Gibt zurück

Byte[]

Ein Byte Array, das die heruntergeladene 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 von Daten.

NotSupportedException

Die Methode wurde für mehrere Threads gleichzeitig aufgerufen.

Beispiele

Das folgende Codebeispiel fordert Daten von einem Server an und zeigt die zurückgegebenen Daten an. Es wird davon ausgegangen, dass remoteUri einen gültigen URI für die angeforderten Daten enthält.

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

Vorsicht

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

Die DownloadData Methode lädt die Ressource mit dem durch den parameter address angegebenen URI herunter. 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 DownloadDataAsync 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.

DownloadData(Uri)

Quelle:

WebClient.cs

Lädt die Ressource als Byte Array aus dem angegebenen URI herunter.

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

Der URI, der durch das Uri-Objekt dargestellt wird, aus dem Daten heruntergeladen werden sollen.

Gibt zurück

Byte[]

Ein Byte Array, das die heruntergeladene Ressource enthält.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

Hinweise

Vorsicht

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

Die DownloadData Methode lädt die Ressource mit dem durch den parameter address angegebenen URI herunter. 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 DownloadDataAsync 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.