Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

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
<asp:DataList />

El tipo DataList expone los siguientes miembros.

  NombreDescripción
Método públicoDataListInicializa una nueva instancia de la clase DataList.
Arriba

  NombreDescripción
Propiedad públicaAccessKeyObtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor web. (Se hereda de WebControl).
Propiedad protegidaAdapterObtiene el adaptador específico del explorador para el control. (Se hereda de Control).
Propiedad públicaAlternatingItemStyleObtiene las propiedades de estilo de los elementos alternos del control DataList.
Propiedad públicaAlternatingItemTemplateObtiene o establece la plantilla para los elementos alternos del control DataList.
Propiedad públicaAppRelativeTemplateSourceDirectoryObtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control. (Se hereda de Control).
Propiedad públicaAttributesObtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a propiedades del control. (Se hereda de WebControl).
Propiedad públicaBackColorObtiene o establece el color de fondo del control de servidor web. (Se hereda de WebControl).
Propiedad públicaBindingContainerInfraestructura. Obtiene el control que contiene el enlace de datos de este control. (Se hereda de Control).
Propiedad públicaBorderColorObtiene o establece el color de borde del control Web. (Se hereda de WebControl).
Propiedad públicaBorderStyleObtiene o establece el estilo del borde del control de servidor web. (Se hereda de WebControl).
Propiedad públicaBorderWidthObtiene o establece el ancho del borde del control de servidor web. (Se hereda de WebControl).
Propiedad públicaCaptionObtiene o establece el texto que se presenta en un elemento de título HTML del control. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda. (Se hereda de BaseDataList).
Propiedad públicaCaptionAlignObtiene o establece la posición horizontal o vertical del elemento de título HTML de un control. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda. (Se hereda de BaseDataList).
Propiedad públicaCellPaddingObtiene o establece la cantidad de espacio entre el contenido de una celda y el borde de la misma. (Se hereda de BaseDataList).
Propiedad públicaCellSpacingObtiene o establece la cantidad de espacio entre las celdas. (Se hereda de BaseDataList).
Propiedad protegidaChildControlsCreatedObtiene un valor que indica si se han creado controles secundarios del control de servidor. (Se hereda de Control).
Propiedad públicaClientIDObtiene el identificador de control del formato HTML generado por ASP.NET. (Se hereda de Control).
Propiedad públicaClientIDModeObtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID. (Se hereda de Control).
Propiedad protegidaClientIDSeparatorObtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Se hereda de Control).
Propiedad protegidaContextObtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Se hereda de Control).
Propiedad públicaControlsObtiene un objeto System.Web.UI.ControlCollection que contiene una colección de controles secundarios en un control de lista de datos. (Se hereda de BaseDataList).
Propiedad públicaControlStyleObtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaControlStyleCreatedObtiene un valor que indica si se ha creado un objeto Style para la propiedad ControlStyle. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaCssClassObtiene o establece la clase hoja de estilos en cascada (CSS) presentada por el control de servidor web en el cliente. (Se hereda de WebControl).
Propiedad públicaDataItemContainerObtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Se hereda de Control).
Propiedad públicaDataKeyFieldObtiene o establece el campo clave del origen de datos especificado por la propiedad DataSource. (Se hereda de BaseDataList).
Propiedad públicaDataKeysObtiene un objeto DataKeyCollection que almacena los valores clave de cada registro de un control de lista de datos. (Se hereda de BaseDataList).
Propiedad protegidaDataKeysArrayObtiene un objeto ArrayList que contiene los valores clave de cada registro de un control de lista de datos. (Se hereda de BaseDataList).
Propiedad públicaDataKeysContainerObtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Se hereda de Control).
Propiedad públicaDataMemberObtiene o establece, en un origen de datos con varios miembros, el miembro de datos específico que se debe enlazar con un control de lista de datos. (Se hereda de BaseDataList).
Propiedad públicaDataSourceObtiene o establece el origen que contiene una lista de valores que se utiliza para rellenar los elementos contenidos en el control. (Se hereda de BaseDataList).
Propiedad públicaDataSourceIDObtiene o establece la propiedad ID del control de origen de datos que debe utilizar el control de lista de datos para recuperar su origen de datos. (Se hereda de BaseDataList).
Propiedad protegidaDesignModeObtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Se hereda de Control).
Propiedad públicaEditItemIndexObtiene o establece el número de índice del elemento del control DataList seleccionado para su edición.
Propiedad públicaEditItemStyleObtiene las propiedades de estilo del elemento del control DataList seleccionado para su edición.
Propiedad públicaEditItemTemplateObtiene o establece la plantilla para el elemento del control DataList seleccionado para su edición.
Propiedad públicaEnabledObtiene o establece un valor que indica si el control de servidor web está habilitado. (Se hereda de WebControl).
Propiedad públicaEnableThemingObtiene o establece un valor que indica si los temas se aplican a este control. (Se hereda de WebControl).
Propiedad públicaEnableViewStateObtiene o establece un valor que indica si el control de servidor debe mantener su estado de vista y el de los controles secundarios que contiene, en el cliente que realiza la solicitud. (Se hereda de Control).
Propiedad protegidaEventsObtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Se hereda de Control).
Propiedad públicaExtractTemplateRowsObtiene o establece un valor que indica si se extraen y se muestran las filas de un control Table, definido en cada plantilla de un control DataList.
Propiedad públicaFontObtiene las propiedades de fuente asociadas al control de servidor web. (Se hereda de WebControl).
Propiedad públicaFooterStyleObtiene las propiedades de estilo de la sección de pie de página del control DataList.
Propiedad públicaFooterTemplateObtiene o establece la plantilla para la sección de pie de página del control DataList.
Propiedad públicaForeColorObtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web. (Se hereda de WebControl).
Propiedad públicaGridLinesObtiene o establece el estilo de la línea de la cuadrícula del control DataList cuando la propiedad RepeatLayout se establece en RepeatLayout.Table. (Invalida a BaseDataList.GridLines).
Propiedad públicaHasAttributesObtiene un valor que indica si el control tiene establecido algún atributo. (Se hereda de WebControl).
Propiedad protegidaHasChildViewStateObtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista. (Se hereda de Control).
Propiedad públicaHeaderStyleObtiene las propiedades de estilo de la sección de encabezado del control DataList.
Propiedad públicaHeaderTemplateObtiene o establece la plantilla para la sección de encabezado del control DataList.
Propiedad públicaHeightObtiene o establece el alto del control de servidor Web. (Se hereda de WebControl).
Propiedad públicaHorizontalAlignObtiene o establece la alineación horizontal de un control de lista de datos en su contenedor. (Se hereda de BaseDataList).
Propiedad públicaIDObtiene o establece el identificador de programación asignado al control de servidor. (Se hereda de Control).
Propiedad protegidaIdSeparatorInfraestructura. Obtiene el carácter utilizado para separar los identificadores de control. (Se hereda de Control).
Propiedad protegidaInitializedObtiene un valor que indica si se ha inicializado el control. (Se hereda de BaseDataList).
Propiedad protegidaIsBoundUsingDataSourceIDObtiene un valor que indica si la propiedad DataSourceID está establecida. (Se hereda de BaseDataList).
Propiedad protegidaIsChildControlStateClearedObtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Se hereda de Control).
Propiedad protegidaIsEnabledObtiene un valor que indica si está habilitado el control. (Se hereda de WebControl).
Propiedad protegidaIsTrackingViewStateObtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Se hereda de Control).
Propiedad protegidaIsViewStateEnabledObtiene un valor que indica si el estado de vista está habilitado para este control. (Se hereda de Control).
Propiedad públicaItemsObtiene una colección de objetos DataListItem que representan los elementos individuales dentro del control.
Propiedad públicaItemStyleObtiene las propiedades de estilo para los elementos del control DataList.
Propiedad públicaItemTemplateObtiene o establece la plantilla para los elementos del control DataList.
Propiedad protegidaLoadViewStateByIDObtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice. (Se hereda de Control).
Propiedad públicaNamingContainerObtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad Control.ID. (Se hereda de Control).
Propiedad públicaPageObtiene una referencia a la instancia Page que contiene el control de servidor. (Se hereda de Control).
Propiedad públicaParentObtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Se hereda de Control).
Propiedad públicaRenderingCompatibilityObtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Se hereda de Control).
Propiedad públicaRepeatColumnsObtiene o establece el número de columnas que se muestran en el control DataList.
Propiedad públicaRepeatDirectionObtiene o establece si el control DataList se muestra vertical u horizontalmente.
Propiedad públicaRepeatLayoutObtiene o establece si el control se muestra en un diseño de tabla o de flujo.
Propiedad protegidaRequiresDataBindingObtiene o establece un valor que indica si el control de lista de datos necesita enlazarse a su origen de datos especificado. (Se hereda de BaseDataList).
Propiedad protegidaSelectArgumentsObtiene un objeto DataSourceSelectArguments que utiliza el control enlazado a datos al recuperar los datos de un control de origen de datos. (Se hereda de BaseDataList).
Propiedad públicaSelectedIndexObtiene o establece el índice del elemento seleccionado del control DataList.
Propiedad públicaSelectedItemObtiene el elemento seleccionado del control DataList.
Propiedad públicaSelectedItemStyleObtiene las propiedades de estilo del elemento seleccionado del control DataList.
Propiedad públicaSelectedItemTemplateObtiene o establece la plantilla para el elemento seleccionado del control DataList.
Propiedad públicaSelectedValueObtiene el valor del campo clave para el elemento de lista de datos seleccionado.
Propiedad públicaSeparatorStyleObtiene las propiedades de estilo del separador entre cada elemento del control DataList.
Propiedad públicaSeparatorTemplateObtiene o establece la plantilla para el separador de elementos del control DataList.
Propiedad públicaShowFooterObtiene o establece un valor que indica si se muestra la sección de pie de página del control DataList.
Propiedad públicaShowHeaderObtiene o establece un valor que indica si se muestra la sección de encabezado del control DataList.
Propiedad públicaSiteObtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño. (Se hereda de Control).
Propiedad públicaSkinIDObtiene o establece la máscara que se va a aplicar al control. (Se hereda de WebControl).
Propiedad públicaStyleObtiene una colección de atributos de texto que se representan como atributo de estilo en la etiqueta externa del control de servidor web. (Se hereda de WebControl).
Propiedad públicaSupportsDisabledAttributeObtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML presentado cuando el valor de la propiedad IsEnabled del control es false. (Se hereda de BaseDataList).
Propiedad públicaTabIndexObtiene o establece el índice de tabulación del control de servidor web. (Se hereda de WebControl).
Propiedad protegidaTagKeyObtiene la etiqueta HTML que se utiliza para representar el control DataList. (Invalida a WebControl.TagKey).
Propiedad protegidaTagNameObtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaTemplateControlObtiene o establece una referencia a la plantilla que contiene este control. (Se hereda de Control).
Propiedad públicaTemplateSourceDirectoryObtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Se hereda de Control).
Propiedad públicaToolTipObtiene o establece el texto que se muestra cuando el puntero del mouse se desplaza sobre el control de servidor web. (Se hereda de WebControl).
Propiedad públicaUniqueIDObtiene el identificador único calificado jerárquicamente para el control de servidor. (Se hereda de Control).
Propiedad públicaUseAccessibleHeaderObtiene o establece un valor que indica si un control de lista de datos presenta su encabezado en un formato accesible. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda. (Se hereda de BaseDataList).
Propiedad públicaValidateRequestModeObtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos. (Se hereda de Control).
Propiedad protegidaViewStateObtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página. (Se hereda de Control).
Propiedad protegidaViewStateIgnoresCaseObtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Se hereda de Control).
Propiedad públicaViewStateModeObtiene o establece el modo del estado de vista de este control. (Se hereda de Control).
Propiedad públicaVisibleObtiene o establece un valor que indica si un control de servidor se debe representar como interfaz de usuario en la página. (Se hereda de Control).
Propiedad públicaWidthObtiene o establece el ancho del control de servidor web. (Se hereda de WebControl).
Arriba

  NombreDescripción
Método protegidoAddAttributesToRenderAgrega atributos y estilos HTML que deben presentarse al objeto HtmlTextWriterTag especificado. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoAddedControlSe le llama una vez que se ha agregado un control secundario a la colección Controls del Control objeto. (Se hereda de Control).
Método protegidoAddParsedSubObjectIndica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega dicho elemento a la colección ControlCollection del control de servidor. (Se hereda de BaseDataList).
Método públicoApplyStyleCopia en el control Web todos los elementos no vacíos del estilo especificado, sobrescribiendo los elementos de estilo existentes del mismo. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método públicoApplyStyleSheetSkinAplica al control las propiedades de estilo definidas en la hoja de estilos de la página. (Se hereda de Control).
Método protegidoBeginRenderTracingComienza el seguimiento en tiempo de diseño de los datos de representación. (Se hereda de Control).
Método protegidoBuildProfileTreeInfraestructura. Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página. (Se hereda de Control).
Método protegidoClearCachedClientIDInfraestructura. Establece en null el valor de ClientID almacenado en caché. (Se hereda de Control).
Método protegidoClearChildControlStateElimina la información sobre el estado de control de los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearChildStateElimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearChildViewStateElimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearEffectiveClientIDModeInfraestructura. Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Se hereda de Control).
Método públicoCopyBaseAttributesCopia las propiedades no encapsuladas por el objeto Style del control de servidor web especificado al control de servidor web desde el que se efectúa la llamada al método. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoCreateChildControlsInfraestructura. Crea un control secundario mediante el estado de vista. (Se hereda de BaseDataList).
Método protegidoCreateControlCollectionCrea un nuevo objeto ControlCollection para guardar los controles secundarios (tanto literales como de servidor) del control de servidor. (Se hereda de Control).
Método protegidoCreateControlHierarchyCrea la jerarquía de controles utilizada para representar el control de lista de datos, con o sin el origen de datos especificado. (Invalida a BaseDataList.CreateControlHierarchy(Boolean)).
Método protegidoCreateControlStyleCrea el objeto de estilo predeterminado utilizado internamente por el control DataList para implementar todas las propiedades relacionadas con el estilo. (Invalida a WebControl.CreateControlStyle()).
Método protegidoCreateDataSourceSelectArgumentsCrea un objeto DataSourceSelectArguments predeterminado utilizado por el control enlazado a datos si no se especifica ningún argumento. (Se hereda de BaseDataList).
Método protegidoCreateItemCrea un objeto DataListItem.
Método públicoDataBind()Enlaza el control y todos sus controles secundarios al origen de datos especificado. (Se hereda de BaseDataList).
Método protegidoDataBind(Boolean)Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding. (Se hereda de Control).
Método protegidoDataBindChildrenEnlaza un origen de datos a los controles secundarios del control de servidor. (Se hereda de Control).
Método públicoDisposeHabilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Se hereda de Control).
Método protegidoEndRenderTracingFinaliza el seguimiento en tiempo de diseño de los datos de representación. (Se hereda de Control).
Método protegidoEnsureChildControlsDetermina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Se hereda de Control).
Método protegidoEnsureDataBoundComprueba que el control de lista de datos requiere el enlace de datos y que se ha especificado un control de origen de datos válido antes de llamar al método DataBind. (Se hereda de BaseDataList).
Método protegidoEnsureIDCrea un identificador para controles que no tiene un identificador asignado. (Se hereda de Control).
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFindControl(String)Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual. (Se hereda de Control).
Método protegidoFindControl(String, Int32)Infraestructura. Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar. (Se hereda de Control).
Método públicoFocusEstablece el foco de entrada en un control. (Se hereda de Control).
Método protegidoGetDataDevuelve un objeto implementado por IEnumerable que representa el origen de datos. (Se hereda de BaseDataList).
Método protegidoGetDesignModeStateInfraestructura. Obtiene datos en tiempo de diseño para un control. (Se hereda de Control).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetRouteUrl(Object)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(RouteValueDictionary)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(String, Object)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(String, RouteValueDictionary)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoGetUniqueIDRelativeToDevuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Se hereda de Control).
Método públicoHasControlsDetermina si el control de servidor contiene controles secundarios. (Se hereda de Control).
Método protegidoHasEventsDevuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Se hereda de Control).
Método protegidoInitializeItemInicializa un objeto DataListItem basado en las plantillas y estilos especificados para el tipo de elemento de lista.
Método protegidoIsLiteralContentInfraestructura. Determina si el control de servidor alberga únicamente contenido literal. (Se hereda de Control).
Método protegidoLoadControlStateRestaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState. (Se hereda de Control).
Método protegidoLoadViewStateCarga el estado de vista previamente guardado del control DataList. (Invalida a WebControl.LoadViewState(Object)).
Método protegidoMapPathSecureRecupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Se hereda de Control).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoMergeStyleCopia en el control Web todos los elementos no vacíos del estilo especificado, pero no sobrescribe los elementos de estilo existentes en el mismo. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoOnBubbleEventDetermina si el evento del control de servidor debe pasarse a la jerarquía de controles de servidor de la interfaz de usuario de la página. (Invalida a Control.OnBubbleEvent(Object, EventArgs)).
Método protegidoOnCancelCommandGenera el evento CancelCommand. Esto permite incluir un control personalizado para el evento.
Método protegidoOnDataBindingInfraestructura. Genera el evento DataBinding de un control BaseDataList. (Se hereda de BaseDataList).
Método protegidoOnDataPropertyChangedSe le llama cuando se cambia una de las propiedades de identificación de origen de datos base, para volver a enlazar el control enlazado a datos a sus datos. (Se hereda de BaseDataList).
Método protegidoOnDataSourceViewChangedGenera el evento DataSourceViewChanged. (Se hereda de BaseDataList).
Método protegidoOnDeleteCommandGenera el evento DeleteCommand. Esto permite incluir un control personalizado para el evento.
Método protegidoOnEditCommandGenera el evento EditCommand. Esto permite incluir un control personalizado para el evento.
Método protegidoOnInitProvoca el evento Init para el control DataList. (Invalida a BaseDataList.OnInit(EventArgs)).
Método protegidoOnItemCommandGenera el evento ItemCommand. Esto permite incluir un control personalizado para el evento.
Método protegidoOnItemCreatedGenera el evento ItemCreated. Esto permite incluir un control personalizado para el evento.
Método protegidoOnItemDataBoundGenera el evento ItemDataBound. Esto permite incluir un control personalizado para el evento.
Método protegidoOnLoadInfraestructura. Genera el evento Load. (Se hereda de BaseDataList).
Método protegidoOnPreRenderInfraestructura. Genera el evento PreRender. (Se hereda de BaseDataList).
Método protegidoOnSelectedIndexChangedProvoca el evento SelectedIndexChanged de un control BaseDataList. (Se hereda de BaseDataList).
Método protegidoOnUnloadGenera el evento Unload. (Se hereda de Control).
Método protegidoOnUpdateCommandGenera el evento UpdateCommand. Esto permite incluir un control personalizado para el evento.
Método protegidoOpenFileObtiene un objeto Stream utilizado para leer un archivo. (Se hereda de Control).
Método protegidoPrepareControlHierarchyPrepara la jerarquía de controles para representarla en el control DataList. (Invalida a BaseDataList.PrepareControlHierarchy()).
Método protegidoRaiseBubbleEventAsigna los orígenes del evento y su información al control principal del control. (Se hereda de Control).
Método protegidoRemovedControlSe le llama una vez que se ha quitado un control secundario de la colección Controls del Control objeto. (Se hereda de Control).
Método protegidoRenderInfraestructura. Presenta el control en el sistema de escritura HTML especificado. (Se hereda de BaseDataList).
Método públicoRenderBeginTagRepresenta la etiqueta HTML de apertura del control en el sistema de escritura especificado. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoRenderChildrenEnvía el contenido del control secundario del control de servidor a un objeto HtmlTextWriter suministrado, que escribe el contenido que se va a representar en el cliente. (Se hereda de Control).
Método protegidoRenderContentsRepresenta los elementos de lista del control DataList. (Invalida a WebControl.RenderContents(HtmlTextWriter)).
Método públicoRenderControl(HtmlTextWriter)Envía el contenido del control de servidor a un objeto HtmlTextWriter que se proporciona y almacena la información de traza sobre el control si dicha traza está habilitada. (Se hereda de Control).
Método protegidoRenderControl(HtmlTextWriter, ControlAdapter)Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado. (Se hereda de Control).
Método públicoRenderEndTagPresenta la etiqueta HTML de cierre del control en el escritor especificado. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoResolveAdapterObtiene el adaptador de controles que se encarga de representar el control especificado. (Se hereda de Control).
Método públicoResolveClientUrlObtiene una dirección URL que el explorador puede utilizar. (Se hereda de Control).
Método públicoResolveUrlConvierte una dirección URL en una que el cliente solicitante pueda utilizar. (Se hereda de Control).
Método protegidoSaveControlStateGuarda los cambios de estado de un control de servidor que se hayan producido desde el momento en que se devolvieron al servidor los datos de la página. (Se hereda de Control).
Método protegidoSaveViewStateGuarda los cambios realizados en el estado de vista del control desde el momento en que se devolvió la página al servidor. (Invalida a WebControl.SaveViewState()).
Método protegidoSetDesignModeStateEstablece datos en tiempo de diseño para un control. (Se hereda de Control).
Método públicoSetRenderMethodDelegateInfraestructura. Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal. (Se hereda de Control).
Método públicoSetTraceData(Object, Object)Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento. (Se hereda de Control).
Método públicoSetTraceData(Object, Object, Object)Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento. (Se hereda de Control).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método protegidoTrackViewStateRealiza el seguimiento de los cambios del estado de vista para el control DataList para poder almacenarlos en la propiedad ViewState del control. (Invalida a WebControl.TrackViewState()).
Arriba

  NombreDescripción
Evento públicoCancelCommandSe produce cuando se hace clic en el botón Cancel de un elemento del control DataList.
Evento públicoDataBindingSe produce cuando el control de servidor se enlaza a un origen de datos. (Se hereda de Control).
Evento públicoDeleteCommandSe produce cuando se hace clic en el botón Delete de un elemento del control DataList.
Evento públicoDisposedSe produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET. (Se hereda de Control).
Evento públicoEditCommandSe produce cuando se hace clic en el botón Edit de un elemento del control DataList.
Evento públicoInitTiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Se hereda de Control).
Evento públicoItemCommandSe produce cuando se hace clic en cualquier botón del control DataList.
Evento públicoItemCreatedSe produce en el servidor cuando se crea un elemento en el control DataList.
Evento públicoItemDataBoundSe produce cuando un elemento tiene datos enlazados al control DataList.
Evento públicoLoadSe produce cuando el control de servidor se carga en el objeto Page. (Se hereda de Control).
Evento públicoPreRenderSe produce una vez que se carga el objeto Control, pero antes de su representación. (Se hereda de Control).
Evento públicoSelectedIndexChangedTiene lugar cuando se selecciona un elemento distinto de un control de lista de datos entre cada envío al servidor. (Se hereda de BaseDataList).
Evento públicoUnloadSe produce cuando el control de servidor se descarga de la memoria. (Se hereda de Control).
Evento públicoUpdateCommandSe produce cuando se hace clic en el botón Update de un elemento del control DataList.
Arriba

  NombreDescripción
Método de extensión públicoEnableDynamicData(Type)Sobrecargado. Habilita el comportamiento de datos dinámicos para el control de datos especificado. (Definido por DataControlExtensions).
Método de extensión públicoEnableDynamicData(Type, Object)Sobrecargado. Habilita el comportamiento de datos dinámicos para el control de datos especificado. (Definido por DataControlExtensions).
Método de extensión públicoEnableDynamicData(Type, IDictionary<String, Object>)Sobrecargado. Habilita el comportamiento de datos dinámicos para el control de datos especificado. (Definido por DataControlExtensions).
Método de extensión públicoFindDataSourceControlDevuelve el origen de datos que está asociado al control de datos del control especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoFindFieldTemplateDevuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoFindMetaTableDevuelve el objeto de metatabla para el control de datos contenedor. (Definido por DynamicDataExtensions).
Método de extensión públicoGetDefaultValuesObtiene la colección de los valores predeterminados para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoGetMetaTableObtiene los metadatos de la tabla para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoSetMetaTable(MetaTable)Sobrecargado. Establece los metadatos de la tabla para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoSetMetaTable(MetaTable, IDictionary<String, Object>)Sobrecargado. Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoSetMetaTable(MetaTable, Object)Sobrecargado. Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoTryGetMetaTableDetermina si están disponibles los metadatos de la tabla. (Definido por DynamicDataExtensions).
Arriba

  NombreDescripción
Campo públicoMiembro estáticoCancelCommandNameRepresenta el nombre de comando Cancel. Este campo es de sólo lectura.
Campo públicoMiembro estáticoDeleteCommandNameRepresenta el nombre de comando Delete. Este campo es de sólo lectura.
Campo públicoMiembro estáticoEditCommandNameRepresenta el nombre de comando Edit. Este campo es de sólo lectura.
Campo públicoMiembro estáticoSelectCommandNameRepresenta el nombre de comando Select. Este campo es de sólo lectura.
Campo públicoMiembro estáticoUpdateCommandNameRepresenta el nombre de comando Update. Este campo es de sólo lectura.
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoIAttributeAccessor.GetAttributeInfraestructura. Obtiene un atributo del control Web con el nombre especificado. (Se hereda de WebControl).
Implementación explícita de interfacesMétodo privadoIAttributeAccessor.SetAttributeEstablece un atributo del control Web con el nombre y el valor especificados. (Se hereda de WebControl).
Implementación explícita de interfacesPropiedad privadaIControlBuilderAccessor.ControlBuilderPara obtener una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.GetDesignModeStatePara obtener una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.SetDesignModeStatePara obtener una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.SetOwnerControlInfraestructura. Para obtener una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIControlDesignerAccessor.UserDataPara obtener una descripción de este miembro, vea IControlDesignerAccessor.UserData. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIDataBindingsAccessor.DataBindingsPara obtener una descripción de este miembro, vea IDataBindingsAccessor.DataBindings. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIDataBindingsAccessor.HasDataBindingsPara obtener una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIExpressionsAccessor.ExpressionsPara obtener una descripción de este miembro, vea IExpressionsAccessor.Expressions. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIExpressionsAccessor.HasExpressionsPara obtener una descripción de este miembro, vea IExpressionsAccessor.HasExpressions. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIParserAccessor.AddParsedSubObjectPara obtener una descripción de este miembro, vea IParserAccessor.AddParsedSubObject. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIRepeatInfoUser.GetItemStyleInfraestructura. Para obtener una descripción de este miembro, vea IRepeatInfoUser.GetItemStyle.
Implementación explícita de interfacesPropiedad privadaIRepeatInfoUser.HasFooterInfraestructura. Para obtener una descripción de este miembro, vea IRepeatInfoUser.HasFooter.
Implementación explícita de interfacesPropiedad privadaIRepeatInfoUser.HasHeaderInfraestructura. Para obtener una descripción de este miembro, vea IRepeatInfoUser.HasHeader.
Implementación explícita de interfacesPropiedad privadaIRepeatInfoUser.HasSeparatorsInfraestructura. Para obtener una descripción de este miembro, vea IRepeatInfoUser.HasSeparators.
Implementación explícita de interfacesMétodo privadoIRepeatInfoUser.RenderItemInfraestructura. Para obtener una descripción de este miembro, vea IRepeatInfoUser.RenderItem.
Implementación explícita de interfacesPropiedad privadaIRepeatInfoUser.RepeatedItemCountInfraestructura. Para obtener una descripción de este miembro, vea IRepeatInfoUser.RepeatedItemCount.
Arriba

En este tema:

Introducción

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.

Plantillas

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

Nombre de 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.

Personalizar la apariencia del 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.

Style (propiedad)

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.

Mostrar dirección y diseño

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.

Seguridad

El control DataList puede contener controles que permiten a los usuarios escribir información.

Nota de precauciónPrecaución

Este control se puede utilizar para mostrar los datos especificados por el usuario, que pueden incluir script de cliente malintencionado. Compruebe que cualquier información que se envíe desde un cliente no contiene script ejecutable, instrucciones SQL o cualquier otro código antes de mostrarla en la aplicación. Se pueden utilizar controles de validación para comprobar los datos introducidos por el usuario antes de mostrar el texto de entrada en un control. ASP .NET proporciona una característica de validación de las solicitudes de entrada de datos para bloquear script y código HTML en los datos proporcionados por el usuario.

Para obtener más información sobre seguridad, vea Securing Standard Controls, How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings y Validating User Input in ASP.NET Web Pages.

Sintaxis de la declaración

<asp:DataList
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    Caption="string"
    CaptionAlign="NotSet|Top|Bottom|Left|Right"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DataKeyField="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditItemIndex="integer"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ExtractTemplateRows="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    GridLines="None|Horizontal|Vertical|Both"
    Height="size"
    HorizontalAlign="NotSet|Left|Center|Right|Justify"
    ID="string"
    OnCancelCommand="CancelCommand event handler"
    OnDataBinding="DataBinding event handler"
    OnDeleteCommand="DeleteCommand event handler"
    OnDisposed="Disposed event handler"
    OnEditCommand="EditCommand event handler"
    OnInit="Init event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnUnload="Unload event handler"
    OnUpdateCommand="UpdateCommand event handler"
    RepeatColumns="integer"
    RepeatDirection="Horizontal|Vertical"
    RepeatLayout="Table|Flow"
    runat="server"
    SelectedIndex="integer"
    ShowFooter="True|False"
    ShowHeader="True|False"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    UseAccessibleHeader="True|False"
    Visible="True|False"
    Width="size"
>
        <AlternatingItemStyle />
        <AlternatingItemTemplate>
            <!-- child controls -->
        </AlternatingItemTemplate>
        <EditItemStyle />
        <EditItemTemplate>
            <!-- child controls -->
        </EditItemTemplate>
        <FooterStyle />
        <FooterTemplate>
            <!-- child controls -->
        </FooterTemplate>
        <HeaderStyle />
        <HeaderTemplate>
            <!-- child controls -->
        </HeaderTemplate>
        <ItemStyle />
        <ItemTemplate>
            <!-- child controls -->
        </ItemTemplate>
        <SelectedItemStyle />
        <SelectedItemTemplate>
            <!-- child controls -->
        </SelectedItemTemplate>
        <SeparatorStyle />
        <SeparatorTemplate>
            <!-- child controls -->
        </SeparatorTemplate>
</asp:DataList>
TopicLocation
Cómo: Crear plantillas de controles de servidor Web ASP.NETGenerar aplicaciones Web ASP .NET
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: Agregar controles DataList a una página Web ASP.NETGenerar aplicaciones Web ASP .NET
Cómo: Crear plantillas de controles de servidor Web ASP.NET dinámicamenteGenerar aplicaciones Web ASP .NET
Cómo: Personalizar elementos dinámicamente en el control de servidor Web DataListGenerar aplicaciones Web ASP .NET
Cómo: Personalizar elementos DataList en tiempo de ejecuciónGenerar aplicaciones Web ASP .NET
Tutorial: Mostrar y dar formato a datos con el control de servidor Web DataListGenerar 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
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar 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
Cómo: Permitir a los usuarios eliminar elementos en controles DataList de servidor WebGenerar 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: 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: Agregar controles a una página Web ASP.NET mediante programació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: Crear plantillas de controles de servidor Web mediante el DiseñadorGenerar 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
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar aplicaciones con Visual Web Developer
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: 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
Tutorial: Crear páginas Web principal-detalle en Visual StudioGenerar aplicaciones con Visual Web Developer
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

El siguiente ejemplo de código utiliza el modelo de código de un solo archivo y puede que no funcione correctamente si se copia directamente en un archivo de código subyacente. Se debe copiar este ejemplo de código en un archivo de texto vacío con la extensión .aspx. Para obtener más información sobre el modelo de código de los formularios Web Forms, vea ASP.NET Web Page Code Model.



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



.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos 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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft