Repeater.DataSource 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
목록을 채울 데이터를 제공하는 데이터 소스를 가져오거나 설정합니다.
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, setPublic Overridable Property DataSource As Object속성 값
이 컨트롤에 데이터를 제공하는 데 사용된 값 컬렉션을 포함하는 IEnumerable 또는 IListSource 개체입니다. 기본값은 null입니다.
- 특성
예외
지정된 DataSource 개체가 Repeater 컨트롤에 대해 지원되는 데이터 소스가 아닌 경우
DataSource 속성과 DataSourceID 속성 모두에 대해 값이 지정되었기 때문에 데이터 소스를 확인할 수 없는 경우
예제
다음 예제에서는 페이지를 로드할 때 컨트롤의 Repeater 지정 DataSource 하는 방법을 보여 줍니다.
<%@ 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.ArrayList배열 또는 IListSource 개체에 액세스하기 위한 컬렉션 System.Data.DataView 일 수 있습니다System.Collections.IEnumerable. 속성을 설정할 때 데이터 원본에 DataSource 바인딩할 코드를 수동으로 작성해야 합니다.
속성에 지정된 DataSource 데이터 원본에 여러 데이터 원본이 포함된 경우 속성을 사용하여 DataMember 컨트롤에 바인딩할 특정 원본을 지정합니다. 예를 들어 여러 테이블이 있는 System.Data.DataSet 경우 컨트롤에 바인딩할 테이블을 지정해야 합니다. 데이터 원본을 지정한 후 메서드를 DataBind 사용하여 데이터 원본을 컨트롤에 바인딩합니다.
또는 속성을 사용하여 DataSourceID 데이터 원본 컨트롤이 나타내는 데이터 원본에 자동으로 바인딩할 수 있습니다. 속성을 설정 DataSourceID 하면 컨트롤이 Repeater 지정된 데이터 원본 컨트롤에 자동으로 바인딩됩니다. 컨트롤의 Repeater 속성을 동적으로 변경하지 않는 한 메서드를 DataBind 명시적으로 호출하는 코드를 작성할 필요가 없습니다.
속성과 속성 모두에 DataSource 대해 값이 DataSourceID 지정된 경우 ASP.NET 데이터 원본을 확인할 수 없으며 throw System.Web.HttpException 됩니다.