Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Este tema aún no ha recibido ninguna valoración - Valorar este tema

DataGrid (Clase)

.NET Framework 4

Control de lista enlazada a datos que muestra los elementos del origen de datos en una tabla. El control DataGrid permite seleccionar, ordenar y editar estos elementos.

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataList
        System.Web.UI.WebControls.DataGrid

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)
C#
C++
F#
VB
Copiar 
public class DataGrid : BaseDataList, INamingContainer
ASP.NET
Copiar 
<asp:DataGrid />

El tipo DataGrid expone los siguientes miembros.

  Nombre Descripción
Método público DataGrid Inicializa una nueva instancia de la clase DataGrid.
Arriba
  Nombre Descripción
Propiedad pública AccessKey Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor web. (Se hereda de WebControl).
Propiedad protegida Adapter Obtiene el adaptador específico del explorador para el control. (Se hereda de Control).
Propiedad pública AllowCustomPaging Obtiene o establece un valor que indica si está habilitada la paginación personalizada.
Propiedad pública AllowPaging Obtiene o establece un valor que indica si está habilitada la paginación.
Propiedad pública AllowSorting Obtiene o establece un valor que indica si está habilitada la ordenación.
Propiedad pública AlternatingItemStyle Obtiene las propiedades de estilo de los elementos alternos del control DataGrid.
Propiedad pública AppRelativeTemplateSourceDirectory Obtiene 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ública Attributes Obtiene 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ública AutoGenerateColumns Obtiene o establece un valor que indica si se crean y se muestran automáticamente objetos BoundColumn del control DataGrid para cada campo del origen de datos.
Propiedad pública BackColor Obtiene o establece el color de fondo del control de servidor web. (Se hereda de WebControl).
Propiedad pública BackImageUrl Obtiene o establece la dirección URL de una imagen que se va a mostrar en el fondo del control DataGrid.
Propiedad pública BindingContainer Infraestructura. Obtiene el control que contiene el enlace de datos de este control. (Se hereda de Control).
Propiedad pública BorderColor Obtiene o establece el color de borde del control Web. (Se hereda de WebControl).
Propiedad pública BorderStyle Obtiene o establece el estilo del borde del control de servidor web. (Se hereda de WebControl).
Propiedad pública BorderWidth Obtiene o establece el ancho del borde del control de servidor web. (Se hereda de WebControl).
Propiedad pública Caption Obtiene 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ública CaptionAlign Obtiene 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ública CellPadding Obtiene o establece la cantidad de espacio entre el contenido de una celda y el borde de la misma. (Se hereda de BaseDataList).
Propiedad pública CellSpacing Obtiene o establece la cantidad de espacio entre las celdas. (Se hereda de BaseDataList).
Propiedad protegida ChildControlsCreated Obtiene un valor que indica si se han creado controles secundarios del control de servidor. (Se hereda de Control).
Propiedad pública ClientID Obtiene el identificador de control del formato HTML generado por ASP.NET. (Se hereda de Control).
Propiedad pública ClientIDMode Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID. (Se hereda de Control).
Propiedad protegida ClientIDSeparator Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Se hereda de Control).
Propiedad pública Columns Obtiene una colección de objetos que representan las columnas del control DataGrid.
Propiedad protegida Context Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Se hereda de Control).
Propiedad pública Controls Obtiene 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ública ControlStyle Obtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad pública ControlStyleCreated Obtiene 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ública CssClass Obtiene o establece la clase hoja de estilo en cascada (CSS) presentada por el control de servidor web en el cliente. (Se hereda de WebControl).
Propiedad pública CurrentPageIndex Obtiene o establece el índice de la página que se muestra actualmente.
Propiedad pública DataItemContainer Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Se hereda de Control).
Propiedad pública DataKeyField Obtiene o establece el campo clave del origen de datos especificado por la propiedad DataSource. (Se hereda de BaseDataList).
Propiedad pública DataKeys Obtiene un objeto DataKeyCollection que almacena los valores clave de cada registro de un control de lista de datos. (Se hereda de BaseDataList).
Propiedad protegida DataKeysArray Obtiene un objeto ArrayList que contiene los valores clave de cada registro de un control de lista de datos. (Se hereda de BaseDataList).
Propiedad pública DataKeysContainer Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Se hereda de Control).
Propiedad pública DataMember Obtiene 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ública DataSource Obtiene 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ública DataSourceID Obtiene 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 protegida DesignMode Obtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Se hereda de Control).
Propiedad pública EditItemIndex Obtiene o establece el índice de un elemento del control DataGrid para su edición.
Propiedad pública EditItemStyle Obtiene las propiedades de estilo del elemento seleccionado para su edición en el control DataGrid.
Propiedad pública Enabled Obtiene o establece un valor que indica si el control de servidor web está habilitado. (Se hereda de WebControl).
Propiedad pública EnableTheming Obtiene o establece un valor que indica si los temas se aplican a este control. (Se hereda de WebControl).
Propiedad pública EnableViewState Obtiene 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 protegida Events Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Se hereda de Control).
Propiedad pública Font Obtiene las propiedades de fuente asociadas al control de servidor web. (Se hereda de WebControl).
Propiedad pública FooterStyle Obtiene las propiedades de estilo de la sección de pie de página del control DataGrid.
Propiedad pública ForeColor Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web. (Se hereda de WebControl).
Propiedad pública GridLines Obtiene o establece un valor que especifica si se debe mostrar el borde entre las celdas de un control de lista de datos. (Se hereda de BaseDataList).
Propiedad pública HasAttributes Obtiene un valor que indica si el control tiene establecido algún atributo. (Se hereda de WebControl).
Propiedad protegida HasChildViewState Obtiene 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ública HeaderStyle Obtiene las propiedades de estilo de la sección de encabezado del control DataGrid.
Propiedad pública Height Obtiene o establece el alto del control de servidor Web. (Se hereda de WebControl).
Propiedad pública HorizontalAlign Obtiene o establece la alineación horizontal de un control de lista de datos en su contenedor. (Se hereda de BaseDataList).
Propiedad pública ID Obtiene o establece el identificador de programación asignado al control de servidor. (Se hereda de Control).
Propiedad protegida IdSeparator Infraestructura. Obtiene el carácter utilizado para separar los identificadores de control. (Se hereda de Control).
Propiedad protegida Initialized Obtiene un valor que indica si se ha inicializado el control. (Se hereda de BaseDataList).
Propiedad protegida IsBoundUsingDataSourceID Obtiene un valor que indica si la propiedad DataSourceID está establecida. (Se hereda de BaseDataList).
Propiedad protegida IsChildControlStateCleared Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Se hereda de Control).
Propiedad protegida IsEnabled Obtiene un valor que indica si está habilitado el control. (Se hereda de WebControl).
Propiedad protegida IsTrackingViewState Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Se hereda de Control).
Propiedad protegida IsViewStateEnabled Obtiene un valor que indica si el estado de vista está habilitado para este control. (Se hereda de Control).
Propiedad pública Items Obtiene una colección de objetos DataGridItem que representan los elementos individuales del control DataGrid.
Propiedad pública ItemStyle Obtiene las propiedades de estilo de los elementos del control DataGrid.
Propiedad protegida LoadViewStateByID Obtiene 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ública NamingContainer Obtiene 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ública Page Obtiene una referencia a la instancia Page que contiene el control de servidor. (Se hereda de Control).
Propiedad pública PageCount Obtiene el número total de páginas necesario para mostrar los elementos del control DataGrid.
Propiedad pública PagerStyle Obtiene las propiedades de estilo de la sección de paginación del control DataGrid.
Propiedad pública PageSize Obtiene o establece el número de elementos que se van a mostrar en una sola página del control DataGrid.
Propiedad pública Parent Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Se hereda de Control).
Propiedad pública RenderingCompatibility Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Se hereda de Control).
Propiedad protegida RequiresDataBinding Obtiene 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 protegida SelectArguments Obtiene 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ública SelectedIndex Obtiene o establece el índice del elemento seleccionado del control DataGrid.
Propiedad pública SelectedItem Obtiene un objeto DataGridItem que representa el elemento seleccionado del control DataGrid.
Propiedad pública SelectedItemStyle Obtiene las propiedades de estilo del elemento seleccionado actualmente en el control DataGrid.
Propiedad pública ShowFooter Obtiene o establece un valor que indica si se muestra el pie de página en el control DataGrid.
Propiedad pública ShowHeader Obtiene o establece un valor que indica si se muestra el encabezado del control DataGrid.
Propiedad pública Site Obtiene 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ública SkinID Obtiene o establece la máscara que se va a aplicar al control. (Se hereda de WebControl).
Propiedad pública Style Obtiene 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ública SupportsDisabledAttribute Obtiene 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ública TabIndex Obtiene o establece el índice de tabulación del control de servidor web. (Se hereda de WebControl).
Propiedad protegida TagKey Obtiene el valor de HtmlTextWriterTag para el control DataGrid. (Invalida a WebControl.TagKey).
Propiedad protegida TagName Obtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad pública TemplateControl Obtiene o establece una referencia a la plantilla que contiene este control. (Se hereda de Control).
Propiedad pública TemplateSourceDirectory Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Se hereda de Control).
Propiedad pública ToolTip Obtiene 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ública UniqueID Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Se hereda de Control).
Propiedad pública UseAccessibleHeader Obtiene 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 protegida ViewState Obtiene 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 protegida ViewStateIgnoresCase Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Se hereda de Control).
Propiedad pública ViewStateMode Obtiene o establece el modo del estado de vista de este control. (Se hereda de Control).
Propiedad pública VirtualItemCount Obtiene o establece el número virtual de elementos del control DataGrid cuando se utiliza la paginación personalizada.
Propiedad pública Visible Obtiene 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ública Width Obtiene o establece el ancho del control de servidor web. (Se hereda de WebControl).
Arriba
  Nombre Descripción
Método protegido AddAttributesToRender Agrega atributos y estilos HTML que deben presentarse al objeto HtmlTextWriterTag especificado. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegido AddedControl Se 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 protegido AddParsedSubObject Indica 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úblico ApplyStyle Copia 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úblico ApplyStyleSheetSkin Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página. (Se hereda de Control).
Método protegido BuildProfileTree Infraestructura. 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 protegido ClearCachedClientID Infraestructura. Establece en null el valor de ClientID almacenado en caché. (Se hereda de Control).
Método protegido ClearChildControlState Elimina la información sobre el estado de control de los controles secundarios del control de servidor. (Se hereda de Control).
Método protegido ClearChildState Elimina 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 protegido ClearChildViewState Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Se hereda de Control).
Método protegido ClearEffectiveClientIDMode Infraestructura. Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Se hereda de Control).
Método público CopyBaseAttributes Copia 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 programadores de controles. (Se hereda de WebControl).
Método protegido CreateChildControls Infraestructura. Crea un control secundario mediante el estado de vista. (Se hereda de BaseDataList).
Método protegido CreateColumnSet Crea el conjunto de columnas que se va a utilizar para generar la jerarquía de controles. Cuando AutoGenerateColumns es True, se crean columnas para que coincidan con el origen de datos y se anexan al conjunto de columnas definido en la colección Columns.
Método protegido CreateControlCollection Crea un nuevo objeto ControlCollection para guardar los controles secundarios (tanto literales como de servidor) del control de servidor. (Se hereda de Control).
Método protegido CreateControlHierarchy Crea la jerarquía de controles que se utiliza para representar el control DataGrid. (Invalida a BaseDataList.CreateControlHierarchy(Boolean)).
Método protegido CreateControlStyle Crea el nuevo estilo de control. (Invalida a WebControl.CreateControlStyle()).
Método protegido CreateDataSourceSelectArguments Crea un objeto DataSourceSelectArguments predeterminado utilizado por el control enlazado a datos si no se especifica ningún argumento. (Se hereda de BaseDataList).
Método protegido CreateItem Crea un objeto DataGridItem.
Método público DataBind() Enlaza el control y todos sus controles secundarios al origen de datos especificado. (Se hereda de BaseDataList).
Método protegido DataBind(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 protegido DataBindChildren Enlaza un origen de datos a los controles secundarios del control de servidor. (Se hereda de Control).
Método público Dispose Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Se hereda de Control).
Método protegido EnsureChildControls Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Se hereda de Control).
Método protegido EnsureDataBound Comprueba 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 protegido EnsureID Crea un identificador para controles que no tiene un identificador asignado. (Se hereda de Control).
Método público Equals(Object) Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Finalize 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úblico FindControl(String) Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual. (Se hereda de Control).
Método protegido FindControl(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úblico Focus Establece el foco de entrada en un control. (Se hereda de Control).
Método protegido GetData Devuelve un objeto implementado por IEnumerable que representa el origen de datos. (Se hereda de BaseDataList).
Método protegido GetDesignModeState Infraestructura. Obtiene datos en tiempo de diseño para un control. (Se hereda de Control).
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetRouteUrl(Object) Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método público GetRouteUrl(RouteValueDictionary) Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método público GetRouteUrl(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úblico GetRouteUrl(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úblico GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método público GetUniqueIDRelativeTo Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Se hereda de Control).
Método público HasControls Determina si el control de servidor contiene controles secundarios. (Se hereda de Control).
Método protegido HasEvents Devuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Se hereda de Control).
Método protegido InitializeItem Inicializa el objeto DataGridItem especificado.
Método protegido InitializePager Crea un objeto DataGridItem que contiene la interfaz de usuario de paginación.
Método protegido IsLiteralContent Infraestructura. Determina si el control de servidor alberga únicamente contenido literal. (Se hereda de Control).
Método protegido LoadControlState Restaura 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 protegido LoadViewState Carga el estado guardado del control DataGrid. (Invalida a WebControl.LoadViewState(Object)).
Método protegido MapPathSecure Recupera 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 protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método público MergeStyle Copia 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 programadores de controles. (Se hereda de WebControl).
Método protegido OnBubbleEvent Pasa el evento provocado por un control en el contenedor a la jerarquía de controles de servidor de interfaz de usuario de la página. (Invalida a Control.OnBubbleEvent(Object, EventArgs)).
Método protegido OnCancelCommand Provoca el evento CancelCommand. Esto permite incluir un control personalizado para el evento.
Método protegido OnDataBinding Infraestructura. Genera el evento DataBinding de un control BaseDataList. (Se hereda de BaseDataList).
Método protegido OnDataPropertyChanged Se 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 protegido OnDataSourceViewChanged Genera el evento DataSourceViewChanged. (Se hereda de BaseDataList).
Método protegido OnDeleteCommand Provoca el evento DeleteCommand. Esto permite incluir un control personalizado para el evento.
Método protegido OnEditCommand Provoca el evento EditCommand. Esto permite incluir un control personalizado para el evento.
Método protegido OnInit Infraestructura. Provoca el evento Init para el control BaseDataList. (Se hereda de BaseDataList).
Método protegido OnItemCommand Provoca el evento ItemCommand. Esto permite incluir un control personalizado para el evento.
Método protegido OnItemCreated Provoca el evento ItemCreated. Esto permite incluir un control personalizado para el evento.
Método protegido OnItemDataBound Provoca el evento ItemDataBound. Esto permite incluir un control personalizado para el evento.
Método protegido OnLoad Infraestructura. Provoca el evento Load. (Se hereda de BaseDataList).
Método protegido OnPageIndexChanged Provoca el evento PageIndexChanged. Esto permite incluir un control personalizado para el evento.
Método protegido OnPreRender Infraestructura. Provoca el evento PreRender. (Se hereda de BaseDataList).
Método protegido OnSelectedIndexChanged Provoca el evento SelectedIndexChanged de un control BaseDataList. (Se hereda de BaseDataList).
Método protegido OnSortCommand Provoca el evento SortCommand. Esto permite incluir un control personalizado para el evento.
Método protegido OnUnload Provoca el evento Unload. (Se hereda de Control).
Método protegido OnUpdateCommand Provoca el evento UpdateCommand. Esto permite incluir un control personalizado para el evento.
Método protegido OpenFile Obtiene un objeto Stream utilizado para leer un archivo. (Se hereda de Control).
Método protegido PrepareControlHierarchy Infraestructura. Establece la jerarquía de controles para este control DataGrid. (Invalida a BaseDataList.PrepareControlHierarchy()).
Método protegido RaiseBubbleEvent Asigna los orígenes del evento y su información al control principal del control. (Se hereda de Control).
Método protegido RemovedControl Se 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 protegido Render Infraestructura. Presenta el control en el sistema de escritura HTML especificado. (Se hereda de BaseDataList).
Método público RenderBeginTag Presenta la etiqueta HTML de apertura del control en el sistema de escritura especificado. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegido RenderChildren Enví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 protegido RenderContents Presenta el contenido del control en el sistema de escritura especificado. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método público RenderControl(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 protegido RenderControl(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úblico RenderEndTag Presenta la etiqueta HTML de cierre del control en el escritor especificado. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método protegido ResolveAdapter Obtiene el adaptador de controles que se encarga de representar el control especificado. (Se hereda de Control).
Método público ResolveClientUrl Obtiene una dirección URL que el explorador puede utilizar. (Se hereda de Control).
Método público ResolveUrl Convierte una dirección URL en una que el cliente solicitante pueda utilizar. (Se hereda de Control).
Método protegido SaveControlState Guarda 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 protegido SaveViewState Guarda el estado actual de DataGrid. (Invalida a WebControl.SaveViewState()).
Método protegido SetDesignModeState Establece datos en tiempo de diseño para un control. (Se hereda de Control).
Método público SetRenderMethodDelegate Infraestructura. 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úblico ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
Método protegido TrackViewState Marca el punto de inicio del seguimiento y almacenamiento de los cambios en el control como parte del estado de vista del control. (Invalida a WebControl.TrackViewState()).
Arriba
  Nombre Descripción
Evento público CancelCommand Se produce cuando se hace clic en el botón Cancel de un elemento del control DataGrid.
Evento público DataBinding Se produce cuando el control de servidor se enlaza a un origen de datos. (Se hereda de Control).
Evento público DeleteCommand Se produce cuando se hace clic en el botón Eliminar de un elemento del control DataGrid.
Evento público Disposed Se 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úblico EditCommand Se produce cuando se hace clic en el botón Editar de un elemento del control DataGrid.
Evento público Init Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Se hereda de Control).
Evento público ItemCommand Se produce cuando se hace clic en cualquier botón del control DataGrid.
Evento público ItemCreated Se produce en el servidor cuando se crea un elemento en el control DataGrid.
Evento público ItemDataBound Se produce después del enlace de datos de un elemento al control DataGrid.
Evento público Load Se produce cuando el control de servidor se carga en el objeto Page. (Se hereda de Control).
Evento público PageIndexChanged Se produce cuando se hace clic en uno de los elementos de selección de página.
Evento público PreRender Se produce una vez que se carga el objeto Control, pero antes de su representación. (Se hereda de Control).
Evento público SelectedIndexChanged Tiene 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úblico SortCommand Se produce cuando se ordena una columna.
Evento público Unload Se produce cuando el control de servidor se descarga de la memoria. (Se hereda de Control).
Evento público UpdateCommand Se produce cuando se hace clic en el botón Actualizar de un elemento del control DataGrid.
Arriba
  Nombre Descripción
Método de extensión público EnableDynamicData(Type) Sobrecargado. Habilita el comportamiento de datos dinámicos para el control de datos especificado. (Definido por DataControlExtensions).
Método de extensión público EnableDynamicData(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úblico EnableDynamicData(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úblico FindDataSourceControl Devuelve el origen de datos que está asociado al control de datos del control especificado. (Definido por DynamicDataExtensions).
Método de extensión público FindFieldTemplate Devuelve 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úblico FindMetaTable Devuelve el objeto de metatabla para el control de datos contenedor. (Definido por DynamicDataExtensions).
Método de extensión público GetDefaultValues Obtiene la colección de los valores predeterminados para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión público GetMetaTable Obtiene los metadatos de la tabla para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión público SetMetaTable(MetaTable) Sobrecargado. Establece los metadatos de la tabla para el control de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión público SetMetaTable(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úblico SetMetaTable(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úblico TryGetMetaTable Determina si están disponibles los metadatos de la tabla. (Definido por DynamicDataExtensions).
Arriba
  Nombre Descripción
Campo público Miembro estático CancelCommandName Representa el nombre de comando Cancel. Este campo es de sólo lectura.
Campo público Miembro estático DeleteCommandName Representa el nombre de comando Delete. Este campo es de sólo lectura.
Campo público Miembro estático EditCommandName Representa el nombre de comando Edit. Este campo es de sólo lectura.
Campo público Miembro estático NextPageCommandArgument Representa el argumento de comando Next. Este campo es de sólo lectura.
Campo público Miembro estático PageCommandName Representa el nombre de comando Page. Este campo es de sólo lectura.
Campo público Miembro estático PrevPageCommandArgument Representa el argumento de comando Prev. Este campo es de sólo lectura.
Campo público Miembro estático SelectCommandName Representa el nombre de comando Select. Este campo es de sólo lectura.
Campo público Miembro estático SortCommandName Representa el nombre de comando Sort. Este campo es de sólo lectura.
Campo público Miembro estático UpdateCommandName Representa el nombre de comando Update. Este campo es de sólo lectura.
Arriba
  Nombre Descripción
Implementación explícita de interfaces Método privado IAttributeAccessor.GetAttribute Infraestructura. Obtiene un atributo del control Web con el nombre especificado. (Se hereda de WebControl).
Implementación explícita de interfaces Método privado IAttributeAccessor.SetAttribute Establece un atributo del control Web con el nombre y el valor especificados. (Se hereda de WebControl).
Implementación explícita de interfaces Propiedad privada IControlBuilderAccessor.ControlBuilder Para obtener una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder. (Se hereda de Control).
Implementación explícita de interfaces Método privado IControlDesignerAccessor.GetDesignModeState Para obtener una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState. (Se hereda de Control).
Implementación explícita de interfaces Método privado IControlDesignerAccessor.SetDesignModeState Para obtener una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState. (Se hereda de Control).
Implementación explícita de interfaces Método privado IControlDesignerAccessor.SetOwnerControl Infraestructura. Para obtener una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl. (Se hereda de Control).
Implementación explícita de interfaces Propiedad privada IControlDesignerAccessor.UserData Para obtener una descripción de este miembro, vea IControlDesignerAccessor.UserData. (Se hereda de Control).
Implementación explícita de interfaces Propiedad privada IDataBindingsAccessor.DataBindings Para obtener una descripción de este miembro, vea IDataBindingsAccessor.DataBindings. (Se hereda de Control).
Implementación explícita de interfaces Propiedad privada IDataBindingsAccessor.HasDataBindings Para obtener una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings. (Se hereda de Control).
Implementación explícita de interfaces Propiedad privada IExpressionsAccessor.Expressions Para obtener una descripción de este miembro, vea IExpressionsAccessor.Expressions. (Se hereda de Control).
Implementación explícita de interfaces Propiedad privada IExpressionsAccessor.HasExpressions Para obtener una descripción de este miembro, vea IExpressionsAccessor.HasExpressions. (Se hereda de Control).
Implementación explícita de interfaces Método privado IParserAccessor.AddParsedSubObject Para obtener una descripción de este miembro, vea IParserAccessor.AddParsedSubObject. (Se hereda de Control).
Arriba

En este tema:

Introduction

Utilice el control DataGrid para mostrar los campos de un origen de datos como columnas en una tabla. Cada fila del control DataGrid representa un registro del origen de datos. El control DataGrid admite operaciones de selección, edición, eliminación, paginación y ordenación.

Nota de precaución Precaució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. ASP .NET proporciona una característica de validación de las solicitudes de introducción de datos para bloquear script y código HTML en los datos introducidos por el usuario. También se proporcionan controles de servidor de validación para evaluar los datos introducidos por el usuario. Para obtener más información, vea Sintaxis de los controles de servidor Validation.

Diferentes tipos de columna determinan el comportamiento de las columnas del control. La siguiente tabla contiene los diferentes tipos de columna que se pueden utilizar.

Tipo de columna

Descripción

BoundColumn

Muestra una columna enlazada a un campo de un origen de datos. Muestra cada elemento del campo como texto. Éste es el tipo de columna predeterminado del control DataGrid.

ButtonColumn

Muestra un botón de comando para cada elemento de la columna. Esto permite crear una columna de controles de botón personalizados, como los botones Agregar o Quitar.

EditCommandColumn

Muestra una columna que contiene comandos de edición para cada elemento de la columna.

HyperLinkColumn

Muestra el contenido de cada elemento de la columna como un hipervínculo. El contenido de la columna puede enlazarse a un campo de un origen de datos o texto estático.

TemplateColumn

Muestra cada elemento de la columna según una plantilla especificada. Esto permite incluir controles personalizados en la columna.

De manera predeterminada, la propiedad AutoGenerateColumns está establecida en true, de modo que se crea un objeto BoundColumn para cada campo del origen de datos. A continuación, cada campo se representa como una columna del control DataGrid en el orden de aparición de cada campo en el origen de datos.

También es posible controlar manualmente qué columnas aparecerán en el control DataGrid; para ello, se establece la propiedad AutoGenerateColumns en false y, después, se muestran en la lista las columnas que se desean incluir entre las etiquetas de apertura y cierre <Columns>. Las columnas especificadas se agregan a la colección Columns en el orden en que aparecen en la lista. Esto permite controlar mediante programación las columnas del control DataGrid.

Nota Nota

El orden en que se muestran las columnas en el control DataGrid se rige por el orden en que aparecen en la colección Columns. Si bien se puede cambiar mediante programación el orden de las columnas manipulando la colección Columns, resulta más fácil mostrar las columnas en el orden de presentación deseado.

Se pueden mostrar columnas declaradas explícitamente junto con columnas generadas automáticamente. Cuando se utilizan ambos tipos de columna, se representan primero las columnas declaradas explícitamente y, a continuación, las columnas generadas automáticamente.

Nota Nota

Las columnas generadas automáticamente no se agregan a la colección Columns.

Se puede personalizar la apariencia del control DataGrid 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 DataGrid.

EditItemStyle

Especifica el estilo del elemento que se edita en el control DataGrid.

FooterStyle

Especifica el estilo de la sección de pie de página del control DataGrid.

HeaderStyle

Especifica el estilo de la sección de encabezado del control DataGrid.

ItemStyle

Especifica el estilo de los elementos del control DataGrid.

PagerStyle

Especifica el estilo de la sección de selección de página del control DataGrid.

SelectedItemStyle

Especifica el estilo del elemento seleccionado del control DataGrid.

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 DataGrid.

ShowHeader

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

También se puede controlar la apariencia del control DataGrid agregando mediante programación atributos a las etiquetas <td> y <tr> representadas por el control en el explorador. Los atributos se pueden agregar mediante programación proporcionando código en el controlador de eventos para el evento OnItemCreated o OnItemDataBound.

Para agregar un atributo a la etiqueta <td>, obtenga primero el objeto TableCell que representa la celda del control DataGrid a la que desea agregar el atributo. La colección Control.Controls de la propiedad Item del objeto DataGridItemEventArgs que se pasa al controlador de eventos puede utilizarse para obtener el objeto TableCell deseado. A continuación, se puede usar el método AttributeCollection.Add de la colección Attributes del objeto TableCell para agregar atributos a la etiqueta <td>.

Para agregar un atributo a la etiqueta <tr>, obtenga primero el objeto DataGridItem que representa la fila del control DataGrid a la que desea agregar el atributo. La propiedad Item del objeto DataGridItemEventArgs que se pasa al controlador de eventos puede utilizarse para obtener el objeto DataGridItem deseado. A continuación, se puede usar el método AttributeCollection.Add de la colección Attributes del objeto DataGridItem para agregar atributos a la etiqueta <tr>.

Accesibilidad

Para obtener información sobre cómo configurar este control para que genere un marcado que cumpla las normas de accesibilidad, vea Accesibilidad en Visual Studio y ASP.NET y Controles y accesibilidad en ASP.NET.

Sintaxis de la declaración

Copiar 
<asp:DataGrid
    AccessKey="string"
    AllowCustomPaging="True|False"
    AllowPaging="True|False"
    AllowSorting="True|False"
    AutoGenerateColumns="True|False"
    BackColor="color name|#dddddd"
    BackImageUrl="uri"
    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"
    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"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnSortCommand="SortCommand event handler"
    OnUnload="Unload event handler"
    OnUpdateCommand="UpdateCommand event handler"
    PageSize="integer"
    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 />
        <Columns>
                <asp:BoundColumn
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ReadOnly="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundColumn>
                <asp:ButtonColumn
                    ButtonType="LinkButton|PushButton"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonColumn>
                <asp:EditCommandColumn
                    ButtonType="LinkButton|PushButton"
                    CancelText="string"
                    CausesValidation="True|False"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:EditCommandColumn>
                <asp:HyperLinkColumn
                    DataNavigateUrlField="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    NavigateUrl="uri"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkColumn>
                <asp:TemplateColumn
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    Visible="True|False"
>
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateColumn>
        </Columns>
        <EditItemStyle />
        <FooterStyle />
        <HeaderStyle />
        <ItemStyle />
        <PagerStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            CssClass="string"
            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"
            Height="size"
            HorizontalAlign="NotSet|Left|Center|Right|Justify"
            Mode="NextPrev|NumericPages"
            NextPageText="string"
            OnDisposed="Disposed event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PrevPageText="string"
            VerticalAlign="NotSet|Top|Middle|Bottom"
            Visible="True|False"
            Width="size"
            Wrap="True|False"
        />
        <SelectedItemStyle />
</asp:DataGrid>

Hay un proyecto de sitio web de Visual Studio con código fuente disponible para este tema:Download.

En el ejemplo de código siguiente se muestra cómo utilizar el control DataGrid para mostrar los elementos del origen de datos.

C#
VB
Copiar 

<%@ 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 language="C#" runat="server">

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);

            dt.Rows.Add(dr);
         }

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

      void Page_Load(Object sender, EventArgs e) 
      {

         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }

   </script>

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

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

      <h3>DataGrid Example</h3>

      <b>Product List</b>

      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="true"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle> 

      </asp:DataGrid>

   </form>

</body>
</html>

En el ejemplo de código siguiente se muestra cómo utilizar el control DataGrid para un sencillo carro de la compra.

C#
VB
Copiar 

<%@ 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 language="C#" runat="server">

      DataTable Cart;
      DataView CartView;

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);

            dt.Rows.Add(dr);
         }

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

      void Page_Load(Object sender, EventArgs e) 
      {

         if (Session["DG4_ShoppingCart"] == null) 
         {
            Cart = new DataTable();
            Cart.Columns.Add(new DataColumn("Item", typeof(string)));
            Cart.Columns.Add(new DataColumn("Price", typeof(string)));
            Session["DG4_ShoppingCart"] = Cart;
         }

         else 
         {
            Cart = (DataTable)Session["DG4_ShoppingCart"];
         }    

         CartView = new DataView(Cart);
         ShoppingCart.DataSource = CartView;
         ShoppingCart.DataBind();

         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }

      void Grid_CartCommand(Object sender, DataGridCommandEventArgs e) 
      {

         DataRow dr = Cart.NewRow();

         // e.Item is the table row where the command is raised.
         // For bound columns, the value is stored in the Text property of the TableCell.
         TableCell itemCell = e.Item.Cells[2];
         TableCell priceCell = e.Item.Cells[3];
         string item = itemCell.Text;
         string price = priceCell.Text;

         if (((Button)e.CommandSource).CommandName == "AddToCart") 
         {
            dr[0] = item;
            dr[1] = price;
            Cart.Rows.Add(dr);
         }

         else 
         {  

            // Remove from Cart.

            CartView.RowFilter = "Item='" + item + "'";
            if (CartView.Count > 0) 
            {     
               CartView.Delete(0);
            }
            CartView.RowFilter = "";
         }

         ShoppingCart.DataBind();

      }


   </script>

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

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

   <h3>DataGrid Example</h3>

   <table cellpadding="5">
      <tr valign="top">
         <td>

            <b>Product List</b>

            <asp:DataGrid id="ItemsGrid"
                 BorderColor="black"
                 BorderWidth="1"
                 CellPadding="3"
                 AutoGenerateColumns="false"
                 OnItemCommand="Grid_CartCommand"
                 runat="server">

               <HeaderStyle BackColor="#00aaaa">
               </HeaderStyle>

               <Columns>

                  <asp:ButtonColumn 
                       HeaderText="Add to cart" 
                       ButtonType="PushButton" 
                       Text="Add" 
                       CommandName="AddToCart" />

                  <asp:ButtonColumn 
                       HeaderText="Remove from cart" 
                       ButtonType="PushButton" 
                       Text="Remove" 
                       CommandName="RemoveFromCart" />

                  <asp:BoundColumn 
                       HeaderText="Item" 
                       DataField="StringValue"/>

                  <asp:BoundColumn 
                       HeaderText="Price" 
                       DataField="CurrencyValue" 
                       DataFormatString="{0:c}">

                     <ItemStyle HorizontalAlign="right">
                     </ItemStyle>

                  </asp:BoundColumn>   

               </Columns>

            </asp:DataGrid>

         </td>
         <td>

            <b>Shopping Cart</b>

            <asp:DataGrid id="ShoppingCart" 
                 runat="server"
                 BorderColor="black"
                 BorderWidth="1"
                 GridLines="Both"
                 ShowFooter="false"
                 CellPadding="3"
                 CellSpacing="0">

               <HeaderStyle BackColor="#00aaaa">
               </HeaderStyle>

            </asp:DataGrid> 

         </td>
      </tr>

   </table>

   </form>

</body>
</html>

En el ejemplo de código siguiente se muestra cómo agregar atributos dinámicamente a las etiquetas <td> y <tr> generadas por el control DataGrid.

C#
VB
Copiar


<%@ 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() 
   {
      DataTable dt = new DataTable();
      DataRow dr;

      dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
      dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
      dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

      for (int i = 0; i < 5; i++) 
      {
         dr = dt.NewRow();

         dr[0] = i;
         dr[1] = "Item " + i.ToString();
         dr[2] = 1.23 * (i+1);

         dt.Rows.Add(dr);
      }

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

   void Page_Load(Object sender, EventArgs e) 
   {

      if (!IsPostBack) 
      {
         // Load this data only once.
         ItemsGrid.DataSource = CreateDataSource();
         ItemsGrid.DataBind();
      }

   }

   void Item_Bound(Object sender, DataGridItemEventArgs e) 
   {

      ListItemType itemType = (ListItemType)e.Item.ItemType;

      if ((itemType != ListItemType.Header) &&
          (itemType != ListItemType.Footer) &&
          (itemType != ListItemType.Separator))
      {

         // Get the IntegerValue cell from the grid's column collection.
         TableCell intCell = (TableCell)e.Item.Controls[0];

         // Add attributes to the cell.
         intCell.Attributes.Add("id", "intCell" + e.Item.ItemIndex.ToString());
         intCell.Attributes.Add("OnClick", 
                                "Update_intCell" + 
                                e.Item.ItemIndex.ToString() + 
                                "()");

         // Add attributes to the row.
         e.Item.Attributes.Add("id", "row" + e.Item.ItemIndex.ToString());
         e.Item.Attributes.Add("OnDblClick", 
                                "Update_row" + 
                                e.Item.ItemIndex.ToString() + 
                                "()");

      }

   }

</script>

<script type="text/vbscript">

   sub Update_intCell0 
      Alert "You Selected Cell 0."
   end sub

   sub Update_intCell1 
      Alert "You Selected Cell 1."
   end sub

   sub Update_intCell2 
      Alert "You Selected Cell 2."
   end sub

   sub Update_intCell3 
      Alert "You Selected Cell 3."
   end sub

   sub Update_intCell4 
      Alert "You Selected Cell 4."
   end sub

   sub UpDate_row0 
      Alert "You selected the row 0."
   end sub

   sub UpDate_row1 
      Alert "You selected the row 1."
   end sub

   sub UpDate_row2 
      Alert "You selected the row 2."
   end sub

   sub UpDate_row3 
      Alert "You selected the row 3."
   end sub

   sub UpDate_row4 
      Alert "You selected the row 4."
   end sub   

</script>

<head runat="server">
    <title>
            Adding Attributes to the &lt;td&gt; and &lt;tr&gt; </title>
</head>
<body>

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

      <h3>
            Adding Attributes to the &lt;td&gt; and &lt;tr&gt; <br />
            Tags of a DataGrid Control
      </h3>

      <asp:DataGrid id="ItemsGrid" runat="server"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           ShowFooter="true"
           OnItemDataBound="Item_Bound"
           AutoGenerateColumns="false">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <FooterStyle BackColor="#00aaaa">
         </FooterStyle>

         <Columns>

            <asp:BoundColumn HeaderText="Number" 
                 DataField="IntegerValue">

               <ItemStyle BackColor="yellow">
               </ItemStyle>

            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Item" 
                 DataField="StringValue"/>

            <asp:BoundColumn 
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">

               <ItemStyle HorizontalAlign="right">
               </ItemStyle>

            </asp:BoundColumn>

         </Columns>

      </asp:DataGrid>

      <br /><br />

      Click on one of the cells in the <b>Number</b> column to select the cell.

      <br /><br />

      Double click on a row to select a row.   

   </form>

</body>
</html>
C#
VB
Copiar


<%@ 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 DataGrid 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)));

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

            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);

            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) 
         {
            ItemsGrid.DataSource = CreateDataSource();
            ItemsGrid.DataBind();
         }

      }

      void Button_Click(Object sender, EventArgs e) 
      {

         // Count the number of selected items in the DataGrid control.int count = 0;

         // Display the selected times.
         Message.Text = "You Selected: <br />";

         // Iterate through each item (row) in the DataGrid control and // determine whether it is selected.foreach (DataGridItem item in ItemsGrid.Items)
         {

            DetermineSelection(item, ref count);        

         }

         // If no items are selected, display the appropriate message.if (count == 0)
         {

            Message.Text = "No items selected";

         }

      }

      void DetermineSelection(DataGridItem item, refint count)
      {

         // Retrieve the SelectCheckBox CheckBox control from the specified // item (row) in the DataGrid control.
         CheckBox selection = (CheckBox)item.FindControl("SelectCheckBox");

         // If the item is selected, display the appropriate message and // increment the count of selected items.if (selection != null)
         {

           if (selection.Checked)
           {
              Message.Text += "- " + item.Cells[1].Text + "<br />";
              count++;
           }

         }    

      }

   </script>

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

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

      <h3>DataGrid Example</h3>

      <b>Product List</b>

      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="False"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn DataField="IntegerValue" 
                 HeaderText="Item"/>

            <asp:BoundColumn DataField="StringValue" 
                 HeaderText="Description"/>

            <asp:BoundColumn DataField="CurrencyValue" 
                 HeaderText="Price"
                 DataFormatString="{0:c}">

               <ItemStyle HorizontalAlign="Right">
               </ItemStyle>

            </asp:BoundColumn>

            <asp:TemplateColumn HeaderText="Select Item">

               <ItemTemplate>

                  <asp:CheckBox id="SelectCheckBox"
                       Text="Add to Cart"
                       Checked="False"
                       runat="server"/>

               </ItemTemplate>

            </asp:TemplateColumn>

         </Columns> 

      </asp:DataGrid>

      <br /><br />

      <asp:Button id="SubmitButton"
           Text="Submit"
           OnClick = "Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label id="Message"
           runat="server"/>

   </form>

</body>
</html>

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.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.
¿Le ha resultado útil?
(Caracteres restantes: 1500)
Contenido de la comunidad Agregar
Anotaciones Preguntas más frecuentes