Repeater.DataSource Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Получает или задает источник данных, который предоставляет данные для заполнения списка.

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

Значение свойства

Object

Интерфейс IEnumerable или объект IListSource, содержащий коллекцию значений, используемых для поставки данных этому элементу управления. Значение по умолчанию — null.

Атрибуты
BindableAttribute

Исключения

ArgumentException

Указанный объект DataSource не является поддерживаемым источником данных для элемента управления Repeater.

HttpException

Не удается разрешить источник данных, поскольку значение указанно и для свойства DataSource, и для свойства DataSourceID.

Примеры

В следующем примере показано, как указать DataSource Repeater элемент управления при загрузке страницы.

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

Комментарии

Используйте это свойство, чтобы указать источник данных для заполнения Repeater элемента управления. Может DataSource быть любая System.Collections.IEnumerable коллекция, например System.Data.DataView для доступа к базам данных, массиву System.Collections.ArrayListили объекту IListSource . При установке DataSource свойства необходимо вручную написать код для привязки к источнику данных.

Если источник данных, указанный свойством DataSource , содержит несколько источников данных, используйте DataMember свойство, чтобы указать конкретный источник для привязки к элементу управления. Например, при наличии System.Data.DataSet нескольких таблиц необходимо указать таблицу для привязки к элементу управления. После указания источника данных используйте DataBind метод для привязки источника данных к элементу управления.

Кроме того, можно использовать свойство для автоматической DataSourceID привязки к источнику данных, представленному элементом управления источником данных. При установке DataSourceID свойства Repeater элемент управления автоматически привязывается к указанному элементу управления источником данных. Вам не нужно писать код, который явным образом вызывает DataBind метод, если вы не изменяете свойства Repeater элемента управления динамически.

Если значения указаны как для свойства, так DataSource и DataSourceID для свойства, ASP.NET не может разрешить источник данных и System.Web.HttpException создается исключение.

Применяется к

См. также раздел