Repeater.DataSourceID Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

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 ID properti kontrol sumber data yang Repeater harus digunakan kontrol untuk mengambil sumber datanya.

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

String

Properti ID kontrol sumber data.

Pengecualian

HttpException

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.

Berlaku untuk

Bagikan melalui