Repeater.DataSource Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece el origen de datos que proporciona datos para llenar la lista.

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

Valor de propiedad

Object

Un objeto IEnumerable o IListSource que contiene una colección de valores que se utilizan para suministrar datos a este control. El valor predeterminado es null.

Atributos
BindableAttribute

Excepciones

ArgumentException

El objeto DataSource especificado no es un origen de datos compatible con el control Repeater.

HttpException

No se puede resolver el origen de datos porque se ha especificado un valor tanto para la propiedad DataSource, como para la propiedad DataSourceID.

Ejemplos

En el ejemplo siguiente se muestra cómo especificar el DataSource objeto del Repeater control cuando se carga la página.

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

Comentarios

Utilice esta propiedad para especificar el origen de datos para rellenar el Repeater control. DataSource puede ser cualquier System.Collections.IEnumerable colección, como para System.Data.DataView tener acceso a bases de datos, a System.Collections.ArrayList, o a una matriz, o a un IListSource objeto . Al establecer la DataSource propiedad, debe escribir manualmente el código para enlazar con el origen de datos.

Si el origen de datos especificado por la DataSource propiedad contiene varios orígenes de datos, utilice la DataMember propiedad para especificar el origen específico que se va a enlazar al control. Por ejemplo, si tiene una System.Data.DataSet clase con varias tablas, debe especificar qué tabla se va a enlazar al control. Después de especificar el origen de datos, use el DataBind método para enlazar el origen de datos al control .

Como alternativa, puede usar la DataSourceID propiedad para enlazar automáticamente a un origen de datos representado por un control de origen de datos. Al establecer la DataSourceID propiedad , el Repeater control se enlaza automáticamente al control de origen de datos especificado. No es necesario escribir código que llame explícitamente al DataBind método a menos que cambie dinámicamente las propiedades del Repeater control.

Si se especifican valores para la DataSource propiedad y la DataSourceID propiedad , ASP.NET no puede resolver el origen de datos y se produce una System.Web.HttpException excepción .

Se aplica a

Consulte también