Repeater.DataSource Property (System.Web.UI.WebControls)

DataSource Property

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

Repeater..::.DataSource Property

Gets or sets the data source that provides data for populating the list.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

Visual Basic (Declaration)

<BindableAttribute(True)> _
Public Overridable Property DataSource As Object

Visual Basic (Usage)

Dim instance As Repeater
Dim value As Object

value = instance.DataSource

instance.DataSource = value

[BindableAttribute(true)]
public virtual Object DataSource { get; set; }

Visual C++

[BindableAttribute(true)]
public:
virtual property Object^ DataSource {
    Object^ get ();
    void set (Object^ value);
}

JScript

public function get DataSource () : Object
public function set DataSource (value : Object)

ASP.NET

<asp:Repeater DataSource="Object" />

Property Value

Type: System..::.Object
An IEnumerable or IListSource object that contains a collection of values used to supply data to this control. The default value is nullNothingnullptra null reference (Nothing in Visual Basic).

Exceptions

Exception	Condition
ArgumentException	The DataSource object specified is not a supported source of data for the Repeater control.
HttpException	The data source cannot be resolved because a value is specified for both the DataSource property and the DataSourceID property.

Remarks

Use this property to specify the source of data to populate the Repeater control. The DataSource can be any System.Collections..::.IEnumerable object such as a System.Data..::.DataView for accessing databases, a System.Collections..::.ArrayList, a System.Collections..::.Hashtable, or an array, or an IListSource object. When you set the DataSource property you must manually write the code to bind to the data source.

If the data source specified by the DataSource property contains multiple sources of data, use the DataMember property to specify the specific source to bind to the control. For example, if you have a System.Data..::.DataSet with multiple tables, you must specify which table to bind to the control. After you have specified the data source, use the DataBind method to bind the data source to the control.

Alternately, you can use the DataSourceID property to automatically bind to a data source represented by a data source control. When you set the DataSourceID property, the Repeater control automatically binds to the specified data source control. You do not need to write code that explicitly calls the DataBind method unless you dynamically change properties of the Repeater control.

If values are specified for both the DataSource property and the DataSourceID property, ASP.NET is not able to resolve the data source and a System.Web..::.HttpException is thrown.

Examples

The following example demonstrates how to specify the DataSource of the Repeater control when the page is loaded.

Visual Basic

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

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

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Reference

Repeater Class

Repeater Members

System.Web.UI.WebControls Namespace

DataMember

DataSourceID

Other Resources

Repeater Web Server Control Overview