WebClient.DownloadData Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Mengunduh sumber daya sebagai array Byte dari URI yang ditentukan.

Overload

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

DownloadData(String)

Sumber:

WebClient.cs

Mengunduh sumber daya sebagai array Byte 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

Parameter addressnull.

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

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

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

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

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

Nota

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

DownloadData(Uri)

Sumber:

WebClient.cs

Mengunduh sumber daya sebagai array Byte 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 objek Uri, tempat mengunduh data.

Mengembalikan

Byte[]

Array Byte yang berisi sumber daya yang diunduh.

Pengecualian

ArgumentNullException

Parameter addressnull.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

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

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

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

Nota

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