Repeater.DataSource Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit la source de données fournissant les données assurant le remplissage de la liste.

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

Valeur de propriété

Object

Objet IEnumerable ou IListSource qui contient une collection de valeurs utilisées pour fournir des données à ce contrôle. La valeur par défaut est null.

Attributs: BindableAttribute

Exceptions

ArgumentException

L'objet DataSource spécifié ne correspond à aucune source de données prise en charge avec le contrôle Repeater.

HttpException

La source de données ne peut pas être déterminée, car une valeur est spécifiée à la fois pour la propriété DataSource et pour la propriété DataSourceID.

Exemples

L’exemple suivant montre comment spécifier le DataSource Repeater contrôle lors du chargement de la page.

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

Remarques

Utilisez cette propriété pour spécifier la source de données pour remplir le Repeater contrôle. Il DataSource peut s’agir de n’importe quelle System.Collections.IEnumerable collection telle que l’accès System.Data.DataView aux bases de données, à un System.Collections.ArrayListtableau ou à un IListSource objet. Lorsque vous définissez la DataSource propriété, vous devez écrire manuellement le code à lier à la source de données.

Si la source de données spécifiée par la DataSource propriété contient plusieurs sources de données, utilisez la DataMember propriété pour spécifier la source spécifique à lier au contrôle. Par exemple, si vous avez plusieurs System.Data.DataSet tables, vous devez spécifier la table à lier au contrôle. Une fois que vous avez spécifié la source de données, utilisez la DataBind méthode pour lier la source de données au contrôle.

Vous pouvez également utiliser la DataSourceID propriété pour établir une liaison automatique à une source de données représentée par un contrôle de source de données. Lorsque vous définissez la DataSourceID propriété, le Repeater contrôle se lie automatiquement au contrôle de source de données spécifié. Vous n’avez pas besoin d’écrire du code qui appelle explicitement la DataBind méthode, sauf si vous modifiez dynamiquement les propriétés du Repeater contrôle.

Si les valeurs sont spécifiées à la fois pour la DataSource propriété et la DataSourceID propriété, ASP.NET n’est pas en mesure de résoudre la source de données et une System.Web.HttpException exception est levée.

S’applique à

Partager via