Sdílet prostřednictvím

Repeater.DataSource Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví zdroj dat, který poskytuje data pro naplnění seznamu.

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

Hodnota vlastnosti

Object

Objekt IEnumerable , IListSource který obsahuje kolekci hodnot sloužících k poskytování dat tomuto ovládacímu prvku. Výchozí hodnota je null.

Atributy
BindableAttribute

Výjimky

ArgumentException

Zadaný DataSource objekt není podporovaným zdrojem dat pro Repeater ovládací prvek.

HttpException

Zdroj dat nelze přeložit, protože je zadána hodnota pro DataSource vlastnost i DataSourceID vlastnost.

Příklady

Následující příklad ukazuje, jak určit DataSource ovládací prvek Repeater při načtení stránky.

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

Poznámky

Tato vlastnost slouží k určení zdroje dat k naplnění Repeater ovládacího prvku. DataSource Může to být libovolná System.Collections.IEnumerable kolekce, například System.Data.DataView pro přístup k databázím, System.Collections.ArrayListpoli nebo objektuIListSource. Při nastavení DataSource vlastnosti je nutné ručně napsat kód pro vazbu ke zdroji dat.

Pokud zdroj dat určený vlastností DataSource obsahuje více zdrojů dat, použijte DataMember tuto vlastnost k určení konkrétního zdroje, který se má svázat s ovládacím prvku. Pokud máte System.Data.DataSet například s více tabulkami, musíte určit, která tabulka se má svázat s ovládacím prvku. Po zadání zdroje dat použijte metodu DataBind k vytvoření vazby zdroje dat k ovládacímu prvku.

Alternativně můžete vlastnost použít DataSourceID k automatické vazbě ke zdroji dat reprezentovaným ovládacím prvek zdroje dat. Když nastavíte DataSourceID vlastnost, Repeater ovládací prvek automaticky vytvoří vazbu na zadaný ovládací prvek zdroje dat. Nemusíte psát kód, který explicitně volá metodu DataBind , pokud dynamicky nezměníte vlastnosti Repeater ovládacího prvku.

Pokud jsou pro vlastnost i DataSourceID vlastnost zadány DataSource hodnoty, ASP.NET nemůže přeložit zdroj dat a System.Web.HttpException je vyvolán.

Platí pro

Viz také