Repeater.DataSourceID Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
public:
virtual property System::String ^ DataSourceID { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataSourceID { get; set; }
member this.DataSourceID : string with get, set
Public Overridable Property DataSourceID As String
Значение свойства
Свойство ID элемента управления источниками данных.
Исключения
Источник данных не может быть разрешен по одной из следующих причин:
Значение указывается как для свойств, DataSource так и DataSourceID для свойств.
Источник данных, указанный свойством, DataSourceID не найден на странице.
Источник данных, указанный свойством, DataSourceID не реализует IDataSource.
Примеры
В следующем примере кода показано, как задать DataSourceID свойство IDSqlDataSource элемента управления. При загрузке Repeater страницы элемент управления привязывается к источнику данных, указанному SqlDataSource элементом управления, и данные отображаются пользователю.
<%@ page language="C#" %>
<!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.DataSourceID Property Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Repeater.DataSourceID Property Example</h3>
<asp:repeater id="Repeater1"
datasourceid="SqlDataSource1"
runat="server">
<headertemplate>
<table border="1">
<tr>
<td><b>Product ID</b></td>
<td><b>Product Name</b></td>
</tr>
</headertemplate>
<itemtemplate>
<tr>
<td> <%# Eval("ProductID") %> </td>
<td> <%# Eval("ProductName") %> </td>
</tr>
</itemtemplate>
<footertemplate>
</table>
</footertemplate>
</asp:repeater>
<asp:sqldatasource id="SqlDataSource1"
connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
selectcommand="SELECT ProductID, ProductName FROM [Products] Where ProductID <= 10"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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.DataSourceID Property Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Repeater.DataSourceID Property Example</h3>
<asp:repeater id="Repeater1"
datasourceid="SqlDataSource1"
runat="server">
<headertemplate>
<table border="1">
<tr>
<td><b>Product ID</b></td>
<td><b>Product Name</b></td>
</tr>
</headertemplate>
<itemtemplate>
<tr>
<td> <%# Eval("ProductID") %> </td>
<td> <%# Eval("ProductName") %> </td>
</tr>
</itemtemplate>
<footertemplate>
</table>
</footertemplate>
</asp:repeater>
<asp:sqldatasource id="SqlDataSource1"
connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
selectcommand="SELECT ProductID, ProductName FROM [Products] Where ProductID <= 10"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Комментарии
DataSourceID Используйте свойство для доступа к ID свойству элемента управления источниками данных, который Repeater элемент управления должен использовать для получения своего источника данных. Элемент управления источником данных, на который ссылается DataSourceID свойство, может быть любым элементом управления, реализующим IDataSource интерфейс. Элемент управления источником данных должен существовать в том же контейнере именования, что Repeater и элемент управления, ссылающийся на него или родительский элемент управления элемента управления Repeater . При указании значения свойства DataSourceIDRepeater элемент управления привязывается к указанному элементу управления версиями данных. Вам не нужно писать код, который явно вызывает DataBind метод.
Кроме того, свойство можно использовать DataSource для указания источника значений для привязки к элементу Repeater управления. Источник данных должен быть коллекцией, реализующей System.Collections.IEnumerable интерфейс (например System.Data.DataViewSystem.Collections.ArrayList , объект или объект) или IListSource интерфейс. При установке DataSource свойства необходимо написать код для выполнения привязки данных.
Если значения указаны как для свойств, так и DataSourceID для DataSource свойств, ASP.NET не может разрешить источник данных, и System.Web.HttpException создается исключение.
Значение этого свойства хранится в состоянии представления.