Repeater.DataSource Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает источник данных, предоставляющий данные для заполнения списка.
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 свойства указано значение.
Примеры
В следующем примере показано, как указать DataSourceRepeater элемент управления при загрузке страницы.
<%@ 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 вызывается.
