Freigeben über

Repeater.DataSourceID Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen der ID Eigenschaft des Datenquellensteuerelements, das das Repeater Steuerelement zum Abrufen der Datenquelle verwenden soll.

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 Datenquellensteuerelements.

Ausnahmen

HttpException

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

  • Ein Wert wird sowohl für die als DataSourceID auch für die DataSource Eigenschaften 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, bindet das Repeater Steuerelement an die Datenquelle, die durch das SqlDataSource Steuerelement angegeben wird, und die Daten werden an den 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, mit dem das Repeater Steuerelement seine Datenquelle abrufen 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 Benennungscontainer wie das Repeater Steuerelement vorhanden sein, das darauf verweist, oder in einem übergeordneten Steuerelement des Repeater Steuerelements. 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 von Werten anzugeben, die an das Repeater Steuerelement gebunden werden sollen. Die Datenquelle muss eine Auflistung sein, die die System.Collections.IEnumerable Schnittstelle (z. B. das System.Data.DataView Objekt System.Collections.ArrayList ) oder die IListSource Schnittstelle implementiert. Wenn Sie die DataSource Eigenschaft festlegen, müssen Sie den Code schreiben, um die Datenbindung auszuführen.

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

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen