WebClient.DownloadData Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan.

Overload

DownloadData(String)	Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan.
DownloadData(Uri)	Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan.

DownloadData(String)

Sumber:

WebClient.cs

Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan.

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

URI tempat mengunduh data.

Mengembalikan

Byte[]

Array Byte yang berisi sumber daya yang diunduh.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat mengunduh data.

NotSupportedException

Metode ini telah dipanggil secara bersamaan pada beberapa utas.

Contoh

Contoh kode berikut meminta data dari server dan menampilkan data yang dikembalikan. Ini mengasumsikan bahwa remoteUri berisi URI yang valid untuk data yang diminta.

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.")

Keterangan

Metode DownloadData ini mengunduh sumber daya dengan URI yang ditentukan oleh address parameter . Metode ini memblokir saat mengunduh sumber daya. Untuk mengunduh sumber daya dan terus mengeksekusi sambil menunggu respons server, gunakan salah DownloadDataAsync satu metode.

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

DownloadData(Uri)

Sumber:

WebClient.cs

Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan.

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 yang diwakili oleh Uri objek , tempat mengunduh data.

Mengembalikan

Byte[]

Array Byte yang berisi sumber daya yang diunduh.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

Keterangan

Metode DownloadData ini mengunduh sumber daya dengan URI yang ditentukan oleh address parameter . Metode ini memblokir saat mengunduh sumber daya. Untuk mengunduh sumber daya dan terus mengeksekusi sambil menunggu respons server, gunakan salah DownloadDataAsync satu metode.

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.