Repeater.DataSource Vlastnost

  • Reference

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 nebo IListSource objekt obsahující kolekci hodnot, které slouží 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 Repeater ovládacího prvku.

HttpException

Zdroj dat nelze přeložit, protože hodnota je určena pro DataSource vlastnost i DataSourceID vlastnost.

Příklady

Následující příklad ukazuje, jak určit DataSource Repeater ovládací prvek 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. Může DataSource se jednat o libovolnou System.Collections.IEnumerable System.Data.DataView kolekci, například pro přístup k databázím, polím System.Collections.ArrayListnebo objektu IListSource . Když nastavíte DataSource vlastnost, musíte kód ručně napsat, aby se svážel se zdrojem dat.

Pokud zdroj dat určený DataSource vlastností obsahuje více zdrojů dat, použijte DataMember vlastnost k určení konkrétního zdroje pro vytvoření vazby na ovládací prvek. 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 pro vytvoření vazby zdroje dat k ovládacímu prvku.

Případně můžete vlastnost použít DataSourceID k automatické vazbě ke zdroji dat reprezentovaným ovládacím prvku 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 nemě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 vyvolá se.

Platí pro

Viz také