WebClient.DownloadString Metode

Definisi

Ruang nama:

System.Net

Rakitan:

netstandard.dll, System.Net.WebClient.dll

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

Overload

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

yang String berisi URI untuk diunduh.

Mengembalikan

String

Yang String berisi sumber daya yang diminta.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

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, , HttpWebRequestServicePoint, 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 Encoding properti untuk mengonversi sumber daya menjadi String. Metode ini memblokir saat mengunduh sumber daya. Untuk mengunduh sumber daya dan melanjutkan eksekusi sambil menunggu respons server, gunakan salah DownloadStringAsync satu metode.

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut 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.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan 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

Yang String berisi sumber daya yang diminta.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

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, , HttpWebRequestServicePoint, 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 Encoding properti untuk mengonversi sumber daya menjadi String. Metode ini memblokir saat mengunduh sumber daya. Untuk mengunduh sumber daya dan melanjutkan eksekusi sambil menunggu respons server, gunakan salah DownloadStringAsync satu metode.

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut 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.

Nota

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