Repeater.DataSourceID Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die ID-Eigenschaft des Datenquellensteuerelements ab, von dem das Repeater-Steuerelement seine Datenquelle abrufen soll, oder legt diese fest.

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

Eigenschaftswert

String

Die ID-Eigenschaft des Datenquellen-Steuerelements.

Ausnahmen

HttpException

Die Datenquelle kann aus einem der folgenden Gründe nicht aufgelöst werden:

Ein Wert wird sowohl für die -Eigenschaft als auch für die DataSource DataSourceID -Eigenschaft angegeben.
Die von der DataSourceID -Eigenschaft angegebene Datenquelle kann auf der Seite nicht gefunden werden.
Die von der DataSourceID -Eigenschaft angegebene Datenquelle implementiert IDataSourcenicht .

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DataSourceID -Eigenschaft auf die ID -Eigenschaft eines SqlDataSource -Steuerelements festgelegt wird. Wenn die Seite geladen wird, wird das Repeater Steuerelement an die Vom SqlDataSource -Steuerelement angegebene Datenquelle gebunden, und die Daten werden dem Benutzer angezeigt.

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

Hinweise

Verwenden Sie die DataSourceID -Eigenschaft, um auf die ID Eigenschaft des Datenquellensteuerelements zuzugreifen, das das Repeater Steuerelement zum Abrufen seiner Datenquelle verwenden soll. Das Datenquellensteuerelement, auf das von der DataSourceID -Eigenschaft verwiesen wird, kann ein beliebiges Steuerelement sein, das die IDataSource -Schnittstelle implementiert. Das Datenquellensteuerelement muss entweder im gleichen Namenscontainer wie das Steuerelement, das Repeater darauf verweist, oder in einem übergeordneten Steuerelement des Repeater Steuerelements vorhanden sein. Wenn Sie einen Wert für die DataSourceID -Eigenschaft angeben, wird das Repeater Steuerelement an das angegebene Datenquellensteuerelement gebunden. Sie müssen keinen Code schreiben, der die DataBind -Methode explizit aufruft.

Alternativ können Sie die DataSource -Eigenschaft verwenden, um die Quelle der Werte anzugeben, die an das Repeater Steuerelement gebunden werden sollen. Die Datenquelle muss eine Auflistung sein, die die System.Collections.IEnumerable -Schnittstelle (z. B. das - oder System.Collections.ArrayList -System.Data.DataViewObjekt) oder die IListSource -Schnittstelle implementiert. Wenn Sie die DataSource -Eigenschaft festlegen, müssen Sie den Code schreiben, um die Datenbindung auszuführen.

Wenn Werte für die DataSource Eigenschaften und DataSourceID angegeben werden, kann ASP.NET die Datenquelle nicht auflösen, und es wird eine System.Web.HttpException Ausnahme ausgelöst.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für:

Freigeben über