WebClient.DownloadString Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Mengunduh sumber daya yang diminta sebagai String. Sumber daya yang akan diunduh dapat ditentukan sebagai String yang berisi URI atau Uri.

Overload

DownloadString(String)	Mengunduh sumber daya yang diminta sebagai String. Sumber daya yang akan diunduh ditentukan sebagai String yang berisi URI.
DownloadString(Uri)	Mengunduh sumber daya yang diminta sebagai String. Sumber daya yang akan diunduh ditentukan sebagai Uri.

DownloadString(String)

Sumber:

WebClient.cs

Mengunduh sumber daya yang diminta sebagai String. Sumber daya yang akan diunduh ditentukan sebagai String yang berisi 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

String yang berisi URI untuk diunduh.

Mengembalikan

String

String yang berisi sumber daya yang diminta.

Pengecualian

ArgumentNullException

Parameter addressnull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat mengunduh sumber daya.

NotSupportedException

Metode ini telah dipanggil secara bersamaan pada beberapa utas.

Contoh

Contoh kode berikut menunjukkan panggilan metode ini.

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

Keterangan

Hati

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

Metode ini mengambil sumber daya yang ditentukan. Setelah mengunduh sumber daya, metode menggunakan pengodean yang ditentukan dalam properti Encoding untuk mengonversi sumber daya ke String. Metode ini memblokir saat mengunduh sumber daya. Untuk mengunduh sumber daya dan melanjutkan eksekusi sambil menunggu respons server, gunakan salah satu metode DownloadStringAsync.

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.

DownloadString(Uri)

Sumber:

WebClient.cs

Mengunduh sumber daya yang diminta sebagai String. Sumber daya yang akan diunduh ditentukan sebagai 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

Objek Uri yang berisi URI untuk diunduh.

Mengembalikan

String

String yang berisi sumber daya yang diminta.

Pengecualian

ArgumentNullException

Parameter addressnull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat mengunduh sumber daya.

NotSupportedException

Metode ini telah dipanggil secara bersamaan pada beberapa utas.

Keterangan

Hati

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

Metode ini mengambil sumber daya yang ditentukan. Setelah mengunduh sumber daya, metode menggunakan pengodean yang ditentukan dalam properti Encoding untuk mengonversi sumber daya ke String. Metode ini memblokir saat mengunduh sumber daya. Untuk mengunduh sumber daya dan melanjutkan eksekusi sambil menunggu respons server, gunakan salah satu metode DownloadStringAsync.

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.