Sdílet prostřednictvím

Repeater.DataSourceID Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví ID vlastnost ovládacího prvku zdroje dat, který Repeater má ovládací prvek použít k načtení jeho zdroje dat.

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

Hodnota vlastnosti

String

Vlastnost ID ovládacího prvku zdroje dat.

Výjimky

HttpException

Zdroj dat nelze vyřešit z některého z následujících důvodů:

Příklady

Následující příklad kódu ukazuje, jak nastavit DataSourceID vlastnost IDSqlDataSource ovládacího prvku. Při načtení Repeater stránky ovládací prvek vytvoří vazbu ke zdroji dat určenému SqlDataSource ovládacím prvku a data se zobrazí uživateli.

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

Poznámky

DataSourceID Vlastnost použijte pro přístup ID k vlastnosti ovládacího prvku zdroje dat, který Repeater má ovládací prvek použít k načtení jeho zdroje dat. Ovládací prvek zdroje dat, na který odkazuje DataSourceID vlastnost, může být libovolný ovládací prvek, který implementuje IDataSource rozhraní. Ovládací prvek zdroje dat musí existovat buď ve stejném kontejneru pojmenování jako Repeater ovládací prvek, který na něj odkazuje, nebo v nadřazené správě Repeater ovládacího prvku. Když zadáte hodnotu vlastnosti DataSourceID , Repeater ovládací prvek vytvoří vazbu na zadaný ovládací prvek zdroje dat. Nemusíte psát kód, který explicitně volá metodu DataBind .

Alternativně můžete pomocí DataSource vlastnosti určit zdroj hodnot pro vytvoření vazby k ovládacímu Repeater prvku. Zdrojem dat musí být kolekce, která implementuje System.Collections.IEnumerable rozhraní (například System.Data.DataViewSystem.Collections.ArrayList objekt) nebo IListSource rozhraní. Při nastavování DataSource vlastnosti je nutné napsat kód pro provedení datové vazby.

Pokud jsou pro oba i DataSourceID vlastnosti zadány DataSource hodnoty, ASP.NET nemůže přeložit zdroj dat a System.Web.HttpException vyvolá se výjimka.

Hodnota této vlastnosti je uložena ve stavu zobrazení.

Platí pro

Viz také