Repeater.DataSourceID Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define a propriedade ID do controle de fonte de dados que o controle Repeater deve usar para recuperar a fonte de dados.

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 da propriedade

String

A propriedade ID do controle de fonte de dados.

Exceções

HttpException

A fonte de dados não pode ser resolvida por um dos seguintes motivos:

Um valor é especificado para as propriedades DataSource e DataSourceID.
A fonte de dados especificada pela propriedade DataSourceID não pode ser encontrada na página.
A fonte de dados especificada pela propriedade DataSourceID não implementa IDataSource.

Exemplos

O exemplo de código a seguir demonstra como definir a DataSourceID propriedade como a ID propriedade de um SqlDataSource controle . Quando a página é carregada, o Repeater controle é associado à fonte de dados especificada pelo SqlDataSource controle e os dados são exibidos para o usuário.

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

Comentários

Use a DataSourceID propriedade para acessar a ID propriedade do controle da fonte de dados que o Repeater controle deve usar para recuperar sua fonte de dados. O controle da fonte de dados referenciado pela DataSourceID propriedade pode ser qualquer controle que implemente a IDataSource interface . O controle da fonte de dados deve existir no mesmo contêiner de nomenclatura que o controle que faz referência a Repeater ele ou em um controle pai do Repeater controle . Quando você especifica um valor para a DataSourceID propriedade , o Repeater controle é associado ao controle de fonte de dados especificado. Você não precisa escrever um código que chame explicitamente o DataBind método .

Como alternativa, você pode usar a DataSource propriedade para especificar a origem dos valores a serem associados ao Repeater controle. A fonte de dados deve ser uma coleção que implementa a System.Collections.IEnumerable interface (como o System.Data.DataView objeto ou System.Collections.ArrayList ) ou a IListSource interface . Ao definir a DataSource propriedade , você deve escrever o código para executar a associação de dados.

Se os valores forem especificados para as DataSource propriedades e DataSourceID , ASP.NET não poderá resolver a fonte de dados e uma exceção System.Web.HttpException será gerada.

O valor dessa propriedade é armazenado no estado de exibição.

Aplica-se a

Compartilhar via