Repeater.DataSource Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur sumber data yang menyediakan data untuk mengisi daftar.
public:
virtual property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };[System.ComponentModel.Bindable(true)]
public virtual object DataSource { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.DataSource : obj with get, setPublic Overridable Property DataSource As ObjectNilai Properti
Objek IEnumerable atau IListSource yang berisi kumpulan nilai yang digunakan untuk menyediakan data ke kontrol ini. Nilai defaultnya adalah null.
- Atribut
Pengecualian
Objek DataSource yang ditentukan bukan sumber data yang didukung untuk Repeater kontrol.
Sumber data tidak dapat diselesaikan karena nilai ditentukan untuk DataSource properti dan DataSourceID properti .
Contoh
Contoh berikut menunjukkan cara menentukan DataSourceRepeater kontrol saat halaman dimuat.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Repeater Example</title>
<script runat="server">
void Page_Load(Object Sender, EventArgs e) {
if (!IsPostBack) {
ArrayList values = new ArrayList();
values.Add("Apple");
values.Add("Orange");
values.Add("Pear");
values.Add("Banana");
values.Add("Grape");
// Set the DataSource of the Repeater.
Repeater1.DataSource = values;
Repeater1.DataBind();
}
}
</script>
</head>
<body>
<h3>Repeater Example</h3>
<form id="form1" runat="server">
<b>Repeater1:</b>
<br />
<asp:Repeater id="Repeater1" runat="server">
<HeaderTemplate>
<table border="1">
</HeaderTemplate>
<ItemTemplate>
<tr>
<td> <%# Container.DataItem %> </td>
</tr>
</ItemTemplate>
<FooterTemplate>
</table>
</FooterTemplate>
</asp:Repeater>
<br />
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Repeater Example</title>
<script runat="server">
Sub Page_Load(Sender As Object, e As EventArgs)
If Not IsPostBack Then
Dim values As New ArrayList()
values.Add("Apple")
values.Add("Orange")
values.Add("Pear")
values.Add("Banana")
values.Add("Grape")
' Set the DataSource of the Repeater.
Repeater1.DataSource = values
Repeater1.DataBind()
End If
End Sub
</script>
</head>
<body>
<h3>Repeater Example</h3>
<form id="form1" runat="server">
<b>Repeater1:</b>
<br />
<asp:Repeater id="Repeater1" runat="server">
<HeaderTemplate>
<table border="1">
</HeaderTemplate>
<ItemTemplate>
<tr>
<td> <%# Container.DataItem %> </td>
</tr>
</ItemTemplate>
<FooterTemplate>
</table>
</FooterTemplate>
</asp:Repeater>
<br />
</form>
</body>
</html>
Keterangan
Gunakan properti ini untuk menentukan sumber data untuk mengisi Repeater kontrol. DataSource dapat berupa koleksi apa pun System.Collections.IEnumerable seperti System.Data.DataView untuk mengakses database, System.Collections.ArrayList, atau array, atau IListSource objek. Saat Anda mengatur properti, DataSource Anda harus menulis kode secara manual untuk mengikat ke sumber data.
Jika sumber data yang ditentukan oleh DataSource properti berisi beberapa sumber data, gunakan DataMember properti untuk menentukan sumber tertentu untuk mengikat kontrol. Misalnya, jika Anda memiliki System.Data.DataSet dengan beberapa tabel, Anda harus menentukan tabel mana yang akan diikat ke kontrol. Setelah Anda menentukan sumber data, gunakan DataBind metode untuk mengikat sumber data ke kontrol.
Secara bergantian, Anda dapat menggunakan DataSourceID properti untuk mengikat secara otomatis ke sumber data yang diwakili oleh kontrol sumber data. Saat Anda mengatur DataSourceID properti , Repeater kontrol secara otomatis mengikat ke kontrol sumber data yang ditentukan. Anda tidak perlu menulis kode yang secara eksplisit memanggil DataBind metode kecuali Anda mengubah properti Repeater kontrol secara dinamis.
Jika nilai ditentukan untuk DataSource properti dan DataSourceID properti , ASP.NET tidak dapat menyelesaikan sumber data dan System.Web.HttpException dilemparkan.
