Repeater.DataSourceID 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.
public:
virtual property System::String ^ DataSourceID { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataSourceID { get; set; }
member this.DataSourceID : string with get, set
Public Overridable Property DataSourceID As String
Nilai Properti
Properti ID
kontrol sumber data.
Pengecualian
Sumber data tidak dapat diselesaikan karena salah satu alasan berikut:
Nilai ditentukan untuk DataSource properti dan DataSourceID .
Sumber data yang ditentukan oleh DataSourceID properti tidak dapat ditemukan di halaman.
Sumber data yang ditentukan oleh DataSourceID properti tidak menerapkan IDataSource.
Contoh
Contoh kode berikut menunjukkan cara mengatur DataSourceID properti ke ID properti SqlDataSource kontrol. Saat halaman dimuat, Repeater kontrol mengikat ke sumber data yang ditentukan oleh SqlDataSource kontrol dan data ditampilkan kepada pengguna.
<%@ page language="C#" %>
<!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.DataSourceID Property Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Repeater.DataSourceID Property Example</h3>
<asp:repeater id="Repeater1"
datasourceid="SqlDataSource1"
runat="server">
<headertemplate>
<table border="1">
<tr>
<td><b>Product ID</b></td>
<td><b>Product Name</b></td>
</tr>
</headertemplate>
<itemtemplate>
<tr>
<td> <%# Eval("ProductID") %> </td>
<td> <%# Eval("ProductName") %> </td>
</tr>
</itemtemplate>
<footertemplate>
</table>
</footertemplate>
</asp:repeater>
<asp:sqldatasource id="SqlDataSource1"
connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
selectcommand="SELECT ProductID, ProductName FROM [Products] Where ProductID <= 10"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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.DataSourceID Property Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Repeater.DataSourceID Property Example</h3>
<asp:repeater id="Repeater1"
datasourceid="SqlDataSource1"
runat="server">
<headertemplate>
<table border="1">
<tr>
<td><b>Product ID</b></td>
<td><b>Product Name</b></td>
</tr>
</headertemplate>
<itemtemplate>
<tr>
<td> <%# Eval("ProductID") %> </td>
<td> <%# Eval("ProductName") %> </td>
</tr>
</itemtemplate>
<footertemplate>
</table>
</footertemplate>
</asp:repeater>
<asp:sqldatasource id="SqlDataSource1"
connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
selectcommand="SELECT ProductID, ProductName FROM [Products] Where ProductID <= 10"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Keterangan
DataSourceID Gunakan properti untuk mengakses ID properti kontrol sumber data yang Repeater harus digunakan kontrol untuk mengambil sumber datanya. Kontrol sumber data yang dirujuk oleh DataSourceID properti dapat menjadi kontrol apa pun yang mengimplementasikan IDataSource antarmuka. Kontrol sumber data harus ada baik dalam kontainer penamaan yang sama dengan Repeater kontrol yang mereferensikannya atau dalam kontrol Repeater induk kontrol. Saat Anda menentukan nilai untuk DataSourceID properti , Repeater kontrol mengikat ke kontrol sumber data yang ditentukan. Anda tidak perlu menulis kode yang secara eksplisit memanggil DataBind metode .
Atau, Anda dapat menggunakan DataSource properti untuk menentukan sumber nilai yang akan diikat ke Repeater kontrol. Sumber data harus berupa koleksi yang mengimplementasikan System.Collections.IEnumerable antarmuka (seperti System.Data.DataView objek atau System.Collections.ArrayList ) atau IListSource antarmuka. Saat Mengatur DataSource properti, Anda harus menulis kode untuk melakukan pengikatan data.
Jika nilai ditentukan untuk DataSource properti dan DataSourceID , ASP.NET tidak dapat menyelesaikan sumber data dan System.Web.HttpException pengecualian dilemparkan.
Nilai properti ini disimpan dalam status tampilan.