Repeater.DataSource 속성

정의

목록을 채울 데이터를 제공하는 데이터 소스를 가져오거나 설정합니다.Gets or sets the data source that provides data for populating the list.

public:
 virtual property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Bindable(true)]
public virtual object DataSource { get; set; }
member this.DataSource : obj with get, set
Public Overridable Property DataSource As Object

속성 값

이 컨트롤에 데이터를 제공하는 데 사용된 값 컬렉션을 포함하는 IEnumerable 또는 IListSource 개체입니다.An IEnumerable or IListSource object that contains a collection of values used to supply data to this control. 기본값은 null입니다.The default value is null.

특성

예외

지정된 DataSource 개체가 Repeater 컨트롤에 대해 지원되는 데이터 소스가 아닌 경우The DataSource object specified is not a supported source of data for the Repeater control.

DataSource 속성과 DataSourceID 속성 모두에 대해 값이 지정되었기 때문에 데이터 소스를 확인할 수 없는 경우The data source cannot be resolved because a value is specified for both the DataSource property and the DataSourceID property.

예제

다음 예제에서는 지정 하는 방법에 설명 합니다 DataSourceRepeater 페이지가 로드 될 때 제어 합니다.The following example demonstrates how to specify the DataSource of the Repeater control when the page is loaded.

<%@ 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 제어 합니다.Use this property to specify the source of data to populate the Repeater control. DataSource 하나일 수 있습니다 System.Collections.IEnumerable 와 같은 컬렉션을 System.Data.DataView 데이터베이스에 액세스 하기 위한을 System.Collections.ArrayList, 배열, 또는를 IListSource 개체입니다.The DataSource can be any System.Collections.IEnumerable collection such as a System.Data.DataView for accessing databases, a System.Collections.ArrayList, or an array, or an IListSource object. 설정 하는 경우는 DataSource 속성 하면 데이터 원본에 바인딩하기 위한 코드를 직접 작성 해야 합니다.When you set the DataSource property you must manually write the code to bind to the data source.

데이터 원본으로 지정 하는 경우는 DataSource 여러 원본의 데이터를 포함 하는 속성을 사용 합니다 DataMember 컨트롤에 바인딩할 특정 소스를 지정 하는 속성입니다.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. 예를 들어 있는 경우는 System.Data.DataSet 여러 테이블을 사용 하 여 컨트롤에 바인딩할 테이블을 지정 해야 합니다.For example, if you have a System.Data.DataSet with multiple tables, you must specify which table to bind to the control. 데이터 소스를 지정한 후 사용 하 여는 DataBind 컨트롤에 데이터 소스를 바인딩할 메서드.After you have specified the data source, use the DataBind method to bind the data source to the control.

또는 사용할 수는 DataSourceID 속성을 데이터 소스 컨트롤에서 표시 하는 데이터 원본에 자동으로 바인딩됩니다.Alternately, you can use the DataSourceID property to automatically bind to a data source represented by a data source control. 설정 하는 경우는 DataSourceID 속성인을 Repeater 컨트롤에 자동으로 지정 된 데이터 소스 컨트롤에 바인딩합니다.When you set the DataSourceID property, the Repeater control automatically binds to the specified data source control. 호출 코드를 명시적으로 작성할 필요가 없습니다 합니다 DataBind 메서드의 속성을 동적으로 변경 하지 않는 한는 Repeater 제어 합니다.You do not need to write code that explicitly calls the DataBind method unless you dynamically change properties of the Repeater control.

둘 다에 대 한 값을 지정 합니다 DataSource 속성 및 DataSourceID 속성인 ASP.NET 데이터 원본을 확인할 수 없는 및 System.Web.HttpException throw 됩니다.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.

적용 대상

추가 정보