Repeater.DataSourceID Свойство

  • Ссылка

Определение

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

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

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

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

String

Свойство ID элемента управления источника данных.

Исключения

HttpException

Источник данных нельзя использовать изменить в следствии одной из следующих причин:

  • Для свойств и DataSourceID задано DataSource значение .

  • Источник данных, указанный свойством , DataSourceID не найден на странице.

  • Источник данных, указанный свойством DataSourceID , не реализует IDataSource.

Примеры

В следующем примере кода показано, как задать DataSourceID для свойства ID свойство SqlDataSource элемента управления . При загрузке страницы элемент управления привязывается к источнику данных, 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 управления . При указании DataSourceID значения свойства Repeater элемент управления привязывается к указанному элементу управления источником данных. Вам не нужно писать код, который явно вызывает DataBind метод .

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

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

Значение этого свойства хранится в состоянии представления.

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

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