Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como - Avalie este tópico

Classe DataList

Um dados ligados controle de lista que exibe itens usando modelos.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)
[ControlValuePropertyAttribute("SelectedValue")]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class DataList : BaseDataList, INamingContainer, 
	IRepeatInfoUser
<asp:DataList />

Use o DataList controle para exibir um dados definidos pelo modelo limite a lista. The DataList controle suporta a seleção e edição.

O Sumário do DataList controle pode ser manipulado usando modelos. A tabela a seguir lista os modelos com suporte.

Nome do modelo

Descrição

AlternatingItemTemplate

Se definido, fornece o conteúdo e layout para itens no alternadosDataList. Se não definido, ItemTemplate é usado.

EditItemTemplate

Se definido, fornece o conteúdo e o layout para o item sendo editado no DataList. Se não definido, ItemTemplate é usado.

FooterTemplate

Se definido, fornece o conteúdo e layout para a seção de rodapé do DataList. Se não definida, uma seção de rodapé não será exibida.

HeaderTemplate

Se definido, fornece o conteúdo e layout para a seção de cabeçalho do DataList. Se não definida, uma seção de cabeçalho não será exibida.

ItemTemplate

Modelo necessário que fornece o conteúdo e o layout para itens no DataList.

SelectedItemTemplate

Se definido, fornece o conteúdo e o layout para o item selecionado no momento no DataList. Se não definido, ItemTemplate é usado.

SeparatorTemplate

Se definido, fornece o conteúdo e layout para o separador entre os itens a DataList. Se não definida, um separador não será exibido.

No mínimo, a ItemTemplate precisa ser definido para exibir os itens a DataList controle. Modelos adicionais podem ser usados para fornecer uma aparência personalizada à DataList controle.

A aparência do DataList controle pode ser personalizado pelo configuração as propriedades de estilo para diferentes partes do controle. A tabela a seguir lista as propriedades de estilo diferente.

Propriedade Estilo

Descrição

AlternatingItemStyle

Especifica o estilo para itens no alternadosDataList controle.

EditItemStyle

Especifica o estilo para o item que está sendo editado no DataList controle.

FooterStyle

Especifica o estilo do rodapé no DataList controle.

HeaderStyle

Especifica o estilo do cabeçalho no DataList controle.

ItemStyle

Especifica o estilo dos itens no DataList controle.

SelectedItemStyle

Especifica o estilo do item selecionado no DataList controle.

SeparatorStyle

Especifica o estilo para o separador entre os itens no DataList controle.

Você também pode mostrar ou ocultar partes diferentes do controleA tabela a seguir lista as propriedades que controlam quais partes estão mostrados ou ocultos.

Propriedade

Descrição

ShowFooter

Mostra ou oculta a seção de rodapé do DataList controle.

ShowHeader

Mostra ou oculta a seção de cabeçalho do DataList controle.

A direção de exibição de um DataList o controle pode ser vertical ou horizontal. conjunto o RepeatDirection propriedade para especificar a direção de exibição.

O layout do DataList controle é controlado com o RepeatLayout propriedade. configuração Esta propriedade como RepeatLayout.Table exibirá o DataList em um formato de tabela, enquanto RepeatLayout.Flow Exibe a DataList sem uma estrutura de tabela.

Observação de cuidadoCuidado:

Este controle pode ser usado para exibir a entrada do usuário, que pode incluir script cliente mal-intencionado.Verifique as informações que são enviadas de um cliente para script executável, instruções SQL, ou outro código antes exibi-lo em seu aplicativo.Você pode usar controles de validação para verificar a entrada do usuário antes de exibir o texto de entrada em um controle.O ASP.NET fornece um recurso de validação de solicitação de entrada para o bloco de script e HTML na entrada do usuário .

Para obter mais informações sobre segurança, consulte Protegendo controles padrão, Como: Proteger contra scripts maliciosos em um aplicativo da Web aplicando codificação HTML nas Seqüências de caracteres, e Validando Entrada de Usuário em Páginas da Web ASP.NET.

TopicLocation
Como criar modelos de controle do servidor da Web ASP.NET:Building ASP .NET Web Applications
Demonstra Passo a passo: Criando e usando ASP.NET Mestre páginas em Visual Web Developerdv_vwdcon
Como: Personalizar itens dinamicamente no Controlar DataList Servidor Webdv_aspnetcon
Como: Criar modelos de Controlar da Web ASP.NET Declarativelydv_aspnetcon
Como: Allow Usuários to Excluir itens in DataList Servidor Web Controlesdv_aspnetcon
Como: Adicionar to an ASP.NET Controles DataList Página da Webdv_aspnetcon
Como: Specify Horizontal or Layout Vertical in DataList Servidor Web Controlesdv_aspnetcon
Como: Criar Servidor Web controle modelos com o designerdv_vwdcon
Demonstra Passo a passo: Exibindo e formatação de dados com o DataList Servidor Web de controledv_vwdcon
Como: Adicionar to an ASP.NET Controles Página da Web Programmaticallydv_aspnetcon
Como: Criar ASP.NET Servidor Web Controlare modelos dinamicamentedv_aspnetcon
Como: Allow Users to Editar Items in DataList Servidor Web Controlesdv_aspnetcon
Como: Adicionar DataList Servidor Web controles a uma página da Web ASP.NET (Visual Studio)dv_vwdcon
Demonstra Passo a passo: Criar uma página da Web para exibir dados XMLdv_vwdcon
Demonstra Passo a passo: Dados de vinculação a um Personalizar Business objetodv_vwdcon
Como: Vincular a dados em um Templated Controlar em Visual Studiodv_vwdcon
Como: Permitir aos usuários selecionar itens em DataList Servidor Web controlesdv_aspnetcon
Como: Ligar to Data in a Controlar Templateddv_aspnetcon
Como: Responder a eventos do botão em controles ligados a dadosdv_aspnetcon
Como: Specify Fluxo or Formatar Tabela in DataList Servidor Web Controlesdv_aspnetcon
Como: Personalizar itens DataList at Time Rundv_aspnetcon
Como: Responder a eventos do botão em DataList, Repetidora ou itens GridViewdv_aspnetcon
Demonstra Passo a passo: Exibindo um documento XML em uma página de formulários da Web com transformaçõesdv_vwdcon
Demonstra Passo a passo: Criando páginas da Web mestre/detalhes no Visual Studiodv_vwdcon
Como: Personalizar itens dinamicamente em DataList controle de servidor WebBuilding ASP .NET Web Applications in Visual Studio
Como: Permitir aos usuários excluir itens nos controles DataList do servidor WebBuilding ASP .NET Web Applications in Visual Studio
Como: Criar modelos de controle da Web ASP.NET declarativamenteBuilding ASP .NET Web Applications in Visual Studio
Como: Especifica horizontal ou layout vertical em controles DataList do servidor WebBuilding ASP .NET Web Applications in Visual Studio
Como: Adicionar controles a uma página da Web do ASP.NET por programaçãoBuilding ASP .NET Web Applications in Visual Studio
Demonstra Passo a passo: Exibindo e formatando dados com o controle DataList do servidor WebBuilding ASP .NET Web Applications in Visual Studio
Como: Criar controle de servidor Web Templates Using the DesignerBuilding ASP .NET Web Applications in Visual Studio
Como: Criar modelos de controle de servidor Web do ASP.NET dinamicamenteBuilding ASP .NET Web Applications in Visual Studio
Como: Permitir que usuários edição itens nos controles DataList do servidor WebBuilding ASP .NET Web Applications in Visual Studio
Demonstra Passo a passo: Criando um página da Web para exibir dados XMLBuilding ASP .NET Web Applications in Visual Studio
Demonstra Passo a passo: Ligação para um objeto de negócios personalizado de dadosBuilding ASP .NET Web Applications in Visual Studio
Como: BIND a dados em um controle modeloBuilding ASP .NET Web Applications in Visual Studio
Como: Permitir usuários selecionarem itens em controles DataList do servidor WebBuilding ASP .NET Web Applications in Visual Studio
Como: Adicionar controles DataList do servidor Web a uma página da Web do ASP.NETBuilding ASP .NET Web Applications in Visual Studio
Como: Personalizar itens da DataList em time de execuçãoBuilding ASP .NET Web Applications in Visual Studio
Como: BIND a dados em um controle Templated no Visual StudioBuilding ASP .NET Web Applications in Visual Studio
Como: Responder a eventos de botão em controles ligados a dadosBuilding ASP .NET Web Applications in Visual Studio
Como: Especifique fluxo ou formato de tabela in DataList servidor Web ControlsBuilding ASP .NET Web Applications in Visual Studio
Como: Responder a eventos de botão em DataList ou Repeater itensBuilding ASP .NET Web Applications in Visual Studio
Demonstra Passo a passo: Exibindo um documento XML em uma página de Web Forms usando transformaçõesBuilding ASP .NET Web Applications in Visual Studio
Como: personalizar itens dinamicamente em controles de servidor Web DataListdv_vwdcon
Passo a passo: criando e usando páginas mestras do ASP.NET no Visual Web Developerdv_vwdcon
Como: permitir a usuários excluir itens em controles de servidor Web DataListdv_vwdcon
Como: criar modelos de controles da Web ASP.NET declarativamentedv_vwdcon
Como: especificar layout horizontal ou vertical nos controles de servidor Web DataListdv_vwdcon
Como: adicionar controles a uma página da Web ASP.NET por programaçãodv_vwdcon
Passo a passo: exibindo e formatando dados com o controle DataList do servidor Webdv_vwdcon
Como: criar modelos de controle de servidor Web usando o Designerdv_vwdcon
Como: criar modelos de controle de servidor Web do ASP.NET dinamicamentedv_vwdcon
Como: permitir a usuários editar itens nos controles de servidor Web DataListdv_vwdcon
Passo a passo: criando uma página da Web para exibir dados XMLdv_vwdcon
Como: associar dados em um controle Templateddv_vwdcon
Passo a passo: associação de dados em um objeto corporativo personalizadodv_vwdcon
Como: permitir a usuários selecionar itens nos controles de servidor Web DataListdv_vwdcon
How to: Add DataList Web Server Controls to an ASP.NET Web Pagedv_vwdcon
Como: personalizar itens DataList no tempo de execuçãodv_vwdcon
Como: associar dados em um controle Templated no Visual Studiodv_vwdcon
Passo a passo: criando páginas web mestre/detalhes no Visual Studiodv_vwdcon
Como: responder a eventos de botão em controles associados a dadosdv_vwdcon
Como: especificar fluxo ou formato de tabela em controles de servidor Web DataListdv_vwdcon
Como: responder a eventos de botão em itens DataList ou Repeaterdv_vwdcon
Passo a passo: exibindo um documento XML em uma página de formulários da Web usando transformaçõesdv_vwdcon

O exemplo de código a seguir demonstra como usar um DataList controle para exibir uma lista de itens de uma fonte de dados.

ObservaçãoObservação:

Exemplo de código a seguir usa o modelo de arquivo único código e pode não funcionar corretamente se copiado diretamente em um arquivo code-behind.Este exemplo de código deve ser copiado em um arquivo de texto vazia que possui uma extensão.aspx.Para obter mais informações sobre o modelo de código de Web Forms, consulte Modelo de código de página Web do ASP.NET.


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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" >
   <script runat="server">

      ICollection CreateDataSource() 
      {

         // Create sample data for the DataList control.
         DataTable dt = new DataTable();
         DataRow dr;

         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(String)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
         dt.Columns.Add(new DataColumn("ImageValue", typeof(String)));

         // Populate the table with sample values.for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Description for item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
            dr[3] = "Image" + i.ToString() + ".jpg";

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }


      void Page_Load(Object sender, EventArgs e) 
      {

         // Load sample data only once, when the page is first loaded.if (!IsPostBack) 
         {
            ItemsList.DataSource = CreateDataSource();
            ItemsList.DataBind();
         }

      }

   </script>

<head runat="server">
    <title>DataList Example</title>
</head>
<body>

   <form id="form1" runat="server">

      <h3>DataList Example</h3>

      <asp:DataList id="ItemsList"
           BorderColor="black"
           CellPadding="5"
           CellSpacing="5"
           RepeatDirection="Vertical"
           RepeatLayout="Table"
           RepeatColumns="3"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <HeaderTemplate>

            List of items

         </HeaderTemplate>

         <ItemTemplate>

            Description: <br />
            <%# DataBinder.Eval(Container.DataItem, "StringValue") %>

            <br />

            Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %>

            <br />

            <asp:Image id="ProductImage" AlternateText="Product picture" 
                 ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>'
                 runat="server"/>

         </ItemTemplate>

      </asp:DataList>

   </form>

</body>
</html>



Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0, 1.1, 1.0
Isso foi útil para você?
(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR
© 2013 Microsoft. Todos os direitos reservados.