Repeater.DataSourceID Proprietà

Definizione

Ottiene o imposta la proprietà ID del controllo origine dati che il controllo Repeater deve utilizzare per recuperare la propria origine dati.

public virtual string DataSourceID { get; set; }

Valore della proprietà

Proprietà ID del controllo di origine dati.

Eccezioni

L'origine dati non può essere risolta a causa di uno dei motivi riportati di seguito:

Esempio

Nell'esempio di codice seguente viene illustrato come impostare la DataSourceID proprietà sulla ID proprietà di un SqlDataSource controllo . Quando la pagina viene caricata, il Repeater controllo viene associato all'origine dati specificata dal SqlDataSource controllo e i dati vengono visualizzati all'utente.

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

Commenti

Utilizzare la DataSourceID proprietà per accedere alla ID proprietà del controllo origine dati che il Repeater controllo deve utilizzare per recuperare l'origine dati. Il controllo origine dati a cui fa riferimento la DataSourceID proprietà può essere qualsiasi controllo che implementa l'interfaccia IDataSource . Il controllo origine dati deve esistere nello stesso contenitore di denominazione del Repeater controllo che vi fa riferimento o in un controllo padre del Repeater controllo . Quando si specifica un valore per la DataSourceID proprietà, il Repeater controllo viene associato al controllo origine dati specificato. Non è necessario scrivere codice che chiama in modo esplicito il DataBind metodo .

In alternativa, è possibile utilizzare la DataSource proprietà per specificare l'origine dei valori da associare al Repeater controllo. L'origine dati deve essere una raccolta che implementa l'interfaccia System.Collections.IEnumerable ( ad esempio l'oggetto System.Data.DataView o System.Collections.ArrayList ) o l'interfaccia IListSource . Quando si imposta la DataSource proprietà , è necessario scrivere il codice per eseguire il data binding.

Se per le DataSource proprietà e DataSourceID vengono specificati valori, ASP.NET non è in grado di risolvere l'origine dati e viene generata un'eccezione System.Web.HttpException .

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.

Si applica a

Prodotto Versioni
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Vedi anche