Repeater.DataSource Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta l'origine dati che fornisce dati per compilare l'elenco.

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

Valore della proprietà

Object

Oggetto IEnumerable o IListSource che contiene un insieme di valori utilizzati per fornire dati a questo controllo. Il valore predefinito è null.

Attributi
BindableAttribute

Eccezioni

ArgumentException

L'oggetto DataSource specificato non è un'origine dati supportata per il controllo Repeater.

HttpException

L'origine dati non può essere risolta perché è stato specificato un valore sia per la proprietà DataSource che per la proprietà DataSourceID.

Esempio

Nell'esempio seguente viene illustrato come specificare l'oggetto DataSource Repeater del controllo quando viene caricata la pagina.

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

Commenti

Utilizzare questa proprietà per specificare l'origine dei dati per popolare il Repeater controllo. L'oggetto può essere qualsiasi System.Collections.IEnumerable insieme, ad esempio per System.Data.DataView l'accesso DataSource ai database, a o a una System.Collections.ArrayListmatrice o a un IListSource oggetto. Quando si imposta la proprietà è necessario scrivere manualmente il DataSource codice da associare all'origine dati.

Se l'origine dati specificata dalla DataSource proprietà contiene più origini di dati, utilizzare la DataMember proprietà per specificare l'origine specifica da associare al controllo. Ad esempio, se si dispone System.Data.DataSet di più tabelle, è necessario specificare quale tabella associare al controllo. Dopo aver specificato l'origine dati, usare il DataBind metodo per associare l'origine dati al controllo.

In alternativa, è possibile usare la proprietà per associare automaticamente a un'origine DataSourceID dati rappresentata da un controllo origine dati. Quando si imposta la DataSourceID proprietà, il Repeater controllo viene automaticamente associato al controllo origine dati specificato. Non è necessario scrivere codice che chiama in modo esplicito il DataBind metodo a meno che non si modificano dinamicamente le proprietà del Repeater controllo.

Se i valori vengono specificati sia per la proprietà che per la DataSource proprietà, ASP.NET non è in grado di risolvere l'origine DataSourceID dati e viene generato un System.Web.HttpException oggetto .

Si applica a

Vedi anche