Repeater.DataSourceID Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví ID vlastnost ovládacího prvku zdroje dat, který Repeater by měl ovládací prvek použít k načtení 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 přeložit z jednoho z následujících důvodů:

Pro vlastnosti a DataSourceID je zadána DataSource hodnota.
Zdroj dat určený DataSourceID vlastností nelze na stránce najít.
Zdroj dat určený DataSourceID vlastností neimplementuje IDataSource.

Příklady

Následující příklad kódu ukazuje, jak nastavit DataSourceID vlastnost na ID vlastnost SqlDataSource ovládacího prvku. Po načtení Repeater stránky se ovládací prvek sváže se zdrojem dat určeným ovládacím SqlDataSource prvek 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 by měl ovládací prvek použít k načtení zdroje dat. Ovládací prvek zdroje dat, na který odkazuje DataSourceID vlastnost, může být jakýkoli ovládací prvek, který implementuje IDataSource rozhraní. Ovládací prvek zdroje dat musí existovat buď ve stejném kontejneru názvů jako Repeater ovládací prvek, který na něj odkazuje, nebo v nadřazené Repeater ovládací prvek 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 použít DataSource vlastnost k určení zdroje hodnot, které se mají svázat s ovládacím Repeater prvku. Zdrojem dat musí být kolekce, která implementuje System.Collections.IEnumerable rozhraní (například System.Data.DataView objekt nebo System.Collections.ArrayList ) nebo IListSource rozhraní. Když nastavíte DataSource vlastnost, musíte napsat kód pro provedení datové vazby.

Pokud jsou pro vlastnosti a DataSourceID 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