Repeater.DataSourceID Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece la propiedad ID del control de origen de datos que debe utilizar el control Repeater para recuperar su origen de datos.

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

Valor de propiedad

String

La propiedad ID del control de origen de datos.

Excepciones

HttpException

El origen de datos no se puede resolver por una de las razones siguientes:

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la DataSourceID propiedad en la ID propiedad de un SqlDataSource control . Cuando se carga la página, el Repeater control se enlaza al origen de datos especificado por el SqlDataSource control y los datos se muestran al usuario.

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

Comentarios

Utilice la DataSourceID propiedad para tener acceso a la ID propiedad del control de origen de datos que el Repeater control debe usar para recuperar su origen de datos. El control de origen de datos al que hace referencia la DataSourceID propiedad puede ser cualquier control que implemente la IDataSource interfaz. El control de origen de datos debe existir en el mismo contenedor de nomenclatura que el Repeater control que hace referencia a él o en un control primario del Repeater control. Cuando se especifica un valor para la DataSourceID propiedad , el Repeater control se enlaza al control de origen de datos especificado. No es necesario escribir código que llame explícitamente al DataBind método .

Como alternativa, puede usar la DataSource propiedad para especificar el origen de los valores que se van a enlazar al Repeater control. El origen de datos debe ser una colección que implemente la System.Collections.IEnumerable interfaz (como el System.Data.DataView objeto o ) o System.Collections.ArrayList la IListSource interfaz . Al establecer la DataSource propiedad , debe escribir el código para realizar el enlace de datos.

Si se especifican valores para las DataSource propiedades y DataSourceID , ASP.NET no puede resolver el origen de datos y se produce una System.Web.HttpException excepción.

El valor de esta propiedad se almacena en estado de vista.

Se aplica a

Consulte también