¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

DataList (Clase)

Control de lista enlazada a datos que muestra los elementos mediante el uso de plantillas.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

[ControlValuePropertyAttribute("SelectedValue")] 
public class DataList : BaseDataList, INamingContainer, IRepeatInfoUser
/** @attribute ControlValuePropertyAttribute("SelectedValue") */ 
public class DataList extends BaseDataList implements INamingContainer, IRepeatInfoUser
ControlValuePropertyAttribute("SelectedValue") 
public class DataList extends BaseDataList implements INamingContainer, IRepeatInfoUser
No aplicable.

Utilice el control DataList para mostrar una lista enlazada a datos definida por una plantilla. El control DataList admite la selección y la edición.

El contenido del control DataList puede manipularse mediante el uso de plantillas. En la siguiente tabla se enumeran las plantillas compatibles.

Nombre de la plantilla

Descripción

AlternatingItemTemplate

Si se define, determina el contenido y el diseño de los elementos alternos del control DataList. Si no se define, se utiliza ItemTemplate.

EditItemTemplate

Si se define, determina el contenido y el diseño del elemento que se edita en el control DataList. Si no se define, se utiliza ItemTemplate.

FooterTemplate

Si se define, determina el contenido y el diseño de la sección de pie de página del control DataList. Si no se define, no se mostrará ninguna sección de pie de página.

HeaderTemplate

Si se define, determina el contenido y el diseño de la sección de encabezado del control DataList. Si no se define, no se mostrará ninguna sección de encabezado.

ItemTemplate

Plantilla necesaria que determina el contenido y el diseño de los elementos alternos del control DataList.

SelectedItemTemplate

Si se define, determina el contenido y el diseño del elemento seleccionado actual del control DataList. Si no se define, se utiliza ItemTemplate.

SeparatorTemplate

Si se define, determina el contenido y el diseño del separador de elementos del control DataList. Si no se define, no se mostrará ningún separador.

Como mínimo, es necesario que la propiedad ItemTemplate esté definida para que se muestren los elementos del control DataList. Se pueden usar otras plantillas para dar una apariencia personalizada al control DataList.

Se puede personalizar la apariencia del control DataList estableciendo las propiedades de estilo de las diferentes partes del control. En la siguiente tabla se muestran las diferentes propiedades de estilo.

Propiedad de estilo

Descripción

AlternatingItemStyle

Especifica el estilo de los elementos alternos del control DataList.

EditItemStyle

Especifica el estilo del elemento que se está editando en el control DataList.

FooterStyle

Especifica el estilo del pie de página del control DataList.

HeaderStyle

Especifica el estilo del encabezado del control DataList.

ItemStyle

Especifica el estilo de los elementos del control DataList.

SelectedItemStyle

Especifica el estilo del elemento seleccionado del control DataList.

SeparatorStyle

Especifica el estilo del separador de elementos del control DataList.

También se pueden mostrar u ocultar diferentes partes del control. La siguiente tabla contiene las propiedades que controlan qué partes se muestran o se ocultan.

Propiedad

Descripción

ShowFooter

Muestra u oculta la sección de pie de página del control DataList.

ShowHeader

Muestra u oculta la sección de encabezado del control DataList.

La dirección de presentación de un control DataList puede ser vertical u horizontal. Establezca la propiedad RepeatDirection para especificar la dirección de presentación.

El diseño del control DataList se controla mediante la propiedad RepeatLayout. Si se establece esta propiedad en RepeatLayout.Table, el control DataList se muestra en formato de tabla, mientras que si se establece en RepeatLayout.Flow, el control DataList se muestra sin estructura de tabla.

Nota de precauciónPrecaución:

Este control se puede utilizar para mostrar los datos especificados por el usuario, que pueden incluir secuencias de comandos de cliente malintencionadas. Compruebe la presencia, en cualquier tipo de información que se envíe desde un cliente, de secuencias de comandos ejecutables, instrucciones SQL o cualquier otro tipo de código antes de mostrarlo en su aplicación. Puede utilizar controles de validación para verificar los datos proporcionados por el usuario antes de mostrar el texto de entrada en un control. ASP.NET proporciona una característica de validación de solicitudes de entrada disponible para bloquear secuencias de comandos y código HTML en los datos que proporciona el usuario. Para obtener más información, vea Seguridad de controles estándar, Cómo: Proteger una aplicación Web frente a ataques mediante secuencias de comandos aplicando codificación HTML a las cadenas y Validar la información especificada por el usuario en páginas Web ASP.NET.

TemaUbicación
Cómo: Crear plantillas de controles de servidor Web ASP.NETGenerar aplicaciones Web ASP .NET
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar un documento XML en una página de formularios Web Forms mediante transformacionesGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar y dar formato a datos con el control de servidor Web DataListGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles de servidor Web mediante el DiseñadorGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear una página Web para mostrar datos XMLGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles de servidor Web DataList a una página Web ASP.NET (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantilla en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear páginas Web principal-detalle en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar aplicaciones con Visual Web Developer
Tutorial: Crear páginas Web principal-detalle en Visual StudioGenerar aplicaciones con Visual Web Developer
Cómo: Personalizar elementos dinámicamente en el control de servidor Web DataListGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Permitir a los usuarios eliminar elementos en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles Web ASP.NET mediante declaraciónGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Especificar la disposición horizontal o vertical en los controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles a una página Web ASP.NET mediante programaciónGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar y dar formato a datos con el control de servidor web DataListGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles de servidor Web mediante el DiseñadorGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles de servidor Web ASP.NET dinámicamenteGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Permitir que los usuarios editen elementos en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear una página Web para mostrar datos XMLGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantillaGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Personalizar elementos dinámicamente en el control de servidor Web DataListGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Permitir a los usuarios eliminar elementos en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles Web ASP.NET mediante declaraciónGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Especificar la disposición horizontal o vertical en los controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles a una página Web ASP.NET mediante programaciónGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar y dar formato a datos con el control de servidor web DataListGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles de servidor Web mediante el DiseñadorGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles de servidor Web ASP.NET dinámicamenteGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Permitir que los usuarios editen elementos en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear una página Web para mostrar datos XMLGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Permitir que los usuarios seleccionen elementos en los controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles DataList de servidor web a una página web ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Personalizar elementos DataList en tiempo de ejecuciónGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantilla en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a eventos Button en controles enlazados a datosGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Especificar el formato de flujo o tabla en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de botón en elementos DataList o RepeaterGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar un documento XML en una página de formularios Web Forms mediante transformacionesGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles Web ASP.NET mediante declaraciónGenerar aplicaciones Web ASP .NET
Cómo: Permitir a los usuarios eliminar elementos en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Agregar controles DataList a una página Web ASP.NETGenerar aplicaciones Web ASP .NET
Cómo: Especificar la disposición horizontal o vertical en los controles DataList de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Crear plantillas de controles de servidor Web ASP.NET dinámicamenteGenerar aplicaciones Web ASP .NET
Cómo: Permitir que los usuarios editen elementos en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Permitir que los usuarios seleccionen elementos en los controles DataList de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Enlazar a los datos de un control con plantillaGenerar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de botón en elementos DataList, Repeater o GridViewGenerar aplicaciones Web ASP .NET
Cómo: Personalizar elementos dinámicamente en el control de servidor Web DataListGenerar aplicaciones Web ASP .NET
Cómo: Agregar controles a una página Web ASP.NET mediante programaciónGenerar aplicaciones Web ASP .NET
Cómo: Personalizar elementos DataList en tiempo de ejecuciónGenerar aplicaciones Web ASP .NET
Cómo: Responder a eventos Button en controles enlazados a datosGenerar aplicaciones Web ASP .NET
Cómo: Especificar el formato de flujo o tabla en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Enlazar a los datos de un control con plantillaGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Permitir que los usuarios seleccionen elementos en los controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar controles DataList de servidor web a una página web ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Personalizar elementos DataList en tiempo de ejecuciónGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantilla en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a eventos Button en controles enlazados a datosGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Especificar el formato de flujo o tabla en controles DataList de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de botón en elementos DataList o RepeaterGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar un documento XML en una página de formularios Web Forms mediante transformacionesGenerar aplicaciones Web ASP .NET en Visual Studio

En el siguiente ejemplo se muestra cómo usar un control DataList para que ver una lista de elementos de un origen de datos.

NotaNota:

En el siguiente ejemplo de código se utiliza un modelo de código de un solo archivo, y puede no funcionar de forma correcta si se copia directamente en un archivo de código subyacente. Se debe copiar este código de ejemplo en un archivo de texto vacío con una extensión .aspx. Para obtener más información sobre el modelo de código de los formularios Web Forms, vea Modelo de código de las páginas Web 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>


Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
Mostrar:
© 2015 Microsoft