Repeater.DataSourceID Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit la propriété ID du contrôle de source de données que le contrôle Repeater doit utiliser pour récupérer sa source de données.

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

Valeur de propriété

String

Propriété ID du contrôle de source de données.

Exceptions

HttpException

La source de données ne peut pas être résolue pour l'une des raisons suivantes :

Une valeur est spécifiée pour les DataSource propriétés et .DataSourceID
La source de données spécifiée par la DataSourceID propriété est introuvable dans la page.
La source de données spécifiée par la DataSourceID propriété n’implémente IDataSourcepas .

Exemples

L’exemple de code suivant montre comment définir la DataSourceID propriété sur la ID propriété d’un SqlDataSource contrôle. Lorsque la page est chargée, le Repeater contrôle est lié à la source de données spécifiée par le SqlDataSource contrôle et les données sont affichées à l’utilisateur.

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

Remarques

Utilisez la DataSourceID propriété pour accéder à la ID propriété du contrôle de source de données que le Repeater contrôle doit utiliser pour récupérer sa source de données. Le contrôle de source de données référencé par la DataSourceID propriété peut être n’importe quel contrôle qui implémente l’interface IDataSource . Le contrôle de source de données doit exister soit dans le même conteneur d’affectation de noms que le Repeater contrôle qui y fait référence, soit dans un contrôle parent du Repeater contrôle. Lorsque vous spécifiez une valeur pour la DataSourceID propriété, le Repeater contrôle est lié au contrôle de source de données spécifié. Vous n’avez pas besoin d’écrire du code qui appelle explicitement la DataBind méthode .

Vous pouvez également utiliser la DataSource propriété pour spécifier la source des valeurs à lier au Repeater contrôle. La source de données doit être une collection qui implémente l’interface System.Collections.IEnumerable (comme l’objet System.Data.DataView ou System.Collections.ArrayList ) ou l’interface IListSource . Lorsque vous définissez la DataSource propriété, vous devez écrire le code pour effectuer la liaison de données.

Si des valeurs sont spécifiées pour les DataSource propriétés et DataSourceID , ASP.NET n’est pas en mesure de résoudre la source de données et une System.Web.HttpException exception est levée.

La valeur de cette propriété est stockée dans l’état d’affichage.

S’applique à

Partager via