Aracılığıyla paylaş

Repeater.DataSource Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Listeyi doldurmaya yönelik verileri sağlayan veri kaynağını alır veya ayarlar.

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, set
Public Overridable Property DataSource As Object

Özellik Değeri

Object

IEnumerable Bu denetime veri sağlamak için kullanılan bir değer koleksiyonunu içeren veya IListSource nesnesi. null varsayılan değerdir.

Öznitelikler
BindableAttribute

Özel durumlar

ArgumentException

Belirtilen DataSource nesne denetim için Repeater desteklenen bir veri kaynağı değil.

HttpException

Hem özellik hem de DataSource özellik DataSourceID için bir değer belirtildiğinden veri kaynağı çözümlenemiyor.

Örnekler

Aşağıdaki örnek, sayfa yüklendiğinde denetimin Repeater nasıl belirtileceğini DataSource gösterir.

<%@ 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>

Açıklamalar

Denetimi doldurmak Repeater üzere veri kaynağını belirtmek için bu özelliği kullanın. veritabanlarınaDataSource, bir öğesine, diziye System.Collections.ArrayListveya nesneye erişmek için gibi System.Data.DataView herhangi System.Collections.IEnumerable bir IListSource koleksiyon olabilir. özelliğini ayarladığınızda DataSource , veri kaynağına bağlamak için kodu el ile yazmanız gerekir.

özelliği tarafından DataSource belirtilen veri kaynağı birden çok veri kaynağı içeriyorsa, denetime bağlanacak kaynağı belirtmek için özelliğini kullanın DataMember . Örneğin, birden çok tablo içeren bir System.Data.DataSet tablonuz varsa, denetime hangi tablonun bağlanacağını belirtmeniz gerekir. Veri kaynağını belirttikten sonra, veri kaynağını denetime bağlamak için yöntemini kullanın DataBind .

Alternatif olarak, bir veri kaynağı denetimi tarafından temsil edilen bir veri kaynağına otomatik olarak bağlanmak için özelliğini kullanabilirsiniz DataSourceID . özelliğini ayarladığınızda DataSourceID Repeater , denetim otomatik olarak belirtilen veri kaynağı denetimine bağlanır. Denetimin özelliklerini Repeater dinamik olarak değiştirmediğiniz sürece yöntemini açıkça çağıran DataBind kod yazmanız gerekmez.

Hem özellik hem de DataSource özellik DataSourceID için değerler belirtilirse, ASP.NET veri kaynağını çözümleyemez ve bir System.Web.HttpException oluşturulur.

Şunlara uygulanır

Ayrıca bkz.