Repeater.DataSourceID Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia ID właściwość kontrolki źródła danych, która powinna być używana przez kontrolkę Repeater do pobierania źródła danych.

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

Wartość właściwości

String

Właściwość ID kontrolki źródła danych.

Wyjątki

HttpException

Nie można rozpoznać źródła danych z jednego z następujących powodów:

  • Wartość jest określana zarówno dla właściwości , jak DataSource i DataSourceID .

  • Nie można odnaleźć źródła danych określonego DataSourceID przez właściwość na stronie.

  • Źródło danych określone przez DataSourceID właściwość nie implementuje IDataSourceelementu .

Przykłady

W poniższym przykładzie kodu pokazano, jak ustawić DataSourceID właściwość na ID właściwość kontrolki SqlDataSource . Po załadowaniu strony kontrolka Repeater wiąże się ze źródłem danych określonym przez kontrolkę SqlDataSource , a dane są wyświetlane użytkownikowi.

<%@ 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>

Uwagi

DataSourceID Użyj właściwości , aby uzyskać dostęp do ID właściwości kontrolki źródła danych, która Repeater powinna być używana do pobierania źródła danych. Kontrolka źródła danych, DataSourceID do którego odwołuje się właściwość, może być dowolną kontrolką implementaną interfejsu IDataSource . Kontrolka źródła danych musi istnieć w tym samym kontenerze nazewnictwa co Repeater kontrolka odwołująca się do niej lub w nadrzędnej kontrolce kontrolki Repeater . Po określeniu DataSourceID wartości właściwości kontrolka Repeater wiąże się z określoną kontrolą źródła danych. Nie trzeba pisać kodu, który jawnie wywołuje metodę DataBind .

Alternatywnie możesz użyć DataSource właściwości , aby określić źródło wartości do powiązania z kontrolką Repeater . Źródło danych musi być kolekcją, która implementuje System.Collections.IEnumerable interfejs (taki jak System.Data.DataView obiekt lub System.Collections.ArrayList ) lub IListSource interfejs. Po ustawieniu DataSource właściwości należy napisać kod, aby wykonać powiązanie danych.

Jeśli wartości są określone dla właściwości DataSource i DataSourceID , ASP.NET nie może rozpoznać źródła danych i System.Web.HttpException zgłaszany jest wyjątek.

Wartość tej właściwości jest przechowywana w stanie widoku.

Dotyczy

Zobacz też