Repeater.DataSource Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define a fonte de dados que fornece dados para popular a 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 da propriedade

Object

Um objeto IEnumerable ou IListSource que contém uma coleção de valores usada para fornecer dados a este controle. O valor padrão é null.

Atributos
BindableAttribute

Exceções

ArgumentException

O objeto DataSource especificado não é uma fonte de dados compatível para o controle Repeater.

HttpException

A fonte de dados não pode ser resolvida porque foi especificado um valor para as propriedades DataSource e DataSourceID.

Exemplos

O exemplo a seguir demonstra como especificar o DataSource Repeater controle quando a página é carregada.

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

Comentários

Use essa propriedade para especificar a fonte de dados para preencher o Repeater controle. Pode DataSource ser qualquer System.Collections.IEnumerable coleção como uma System.Data.DataView para acessar bancos de dados, uma matriz ou uma System.Collections.ArrayListmatriz ou um IListSource objeto. Ao definir a DataSource propriedade, você deve gravar manualmente o código para associar à fonte de dados.

Se a fonte de dados especificada pela DataSource propriedade contiver várias fontes de dados, use a DataMember propriedade para especificar a fonte específica a ser associada ao controle. Por exemplo, se você tiver um System.Data.DataSet com várias tabelas, deverá especificar qual tabela associar ao controle. Depois de especificar a fonte de dados, use o DataBind método para associar a fonte de dados ao controle.

Como alternativa, você pode usar a DataSourceID propriedade para associar automaticamente a uma fonte de dados representada por um controle de fonte de dados. Quando você define a DataSourceID propriedade, o Repeater controle é automaticamente associado ao controle de fonte de dados especificado. Você não precisa escrever um código que chame explicitamente o método, DataBind a menos que você altere dinamicamente as propriedades do Repeater controle.

Se os valores forem especificados para a DataSource propriedade e a DataSourceID propriedade, ASP.NET não poderá resolver a fonte de dados e uma System.Web.HttpException será gerada.

Aplica-se a

Confira também