Repeater.DataSourceID Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

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

Valore della proprietà

String

Proprietà ID del controllo di origine dati.

Eccezioni

HttpException

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

Viene specificato un valore per le DataSource proprietà e DataSourceID .
Impossibile trovare l'origine DataSourceID dati specificata dalla proprietà nella pagina.
L'origine dati specificata dalla DataSourceID proprietà non implementa IDataSource.

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>

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

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