Este tema aún no ha recibido ninguna valoración - Valorar este tema

GridView (Clase)

.NET Framework 4

Muestra los valores de un origen de datos en una tabla donde cada columna representa un campo y cada fila representa un registro. El control GridView permite seleccionar, ordenar y modificar estos elementos.

Jerarquía de herencia

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.BaseDataBoundControl
        System.Web.UI.WebControls.DataBoundControl
          System.Web.UI.WebControls.CompositeDataBoundControl
            System.Web.UI.WebControls.GridView

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

Sintaxis

C++

Copiar

[ControlValuePropertyAttribute("SelectedValue")]
public class GridView : CompositeDataBoundControl, IPostBackContainer, 
	IPostBackEventHandler, ICallbackContainer, ICallbackEventHandler, IPersistedSelector, IDataKeysControl, 
	IDataBoundListControl, IDataBoundControl, IFieldControl

ASP.NET

Copiar

<asp:GridView />

El tipo GridView expone los siguientes miembros.

Constructores

	Nombre	Descripción
	GridView	Inicializa una nueva instancia de la clase GridView.

Arriba

Propiedades

	Nombre	Descripción
	AccessKey	Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor web. (Se hereda de WebControl).
	Adapter	Obtiene el adaptador específico del explorador para el control. (Se hereda de Control).
	AllowPaging	Obtiene o establece un valor que indica si la característica de paginación está habilitada.
	AllowSorting	Obtiene o establece un valor que indica si la característica de ordenación está habilitada.
	AlternatingRowStyle	Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de las filas de datos alternas en un control GridView.
	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).
	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).
	AutoGenerateColumns	Obtiene o establece un valor que indica si se deben crear automáticamente campos enlazados para cada campo del origen de datos.
	AutoGenerateDeleteButton	Obtiene o establece un valor que indica si una columna de campo CommandField con un botón Eliminar para cada fila de datos se agrega automáticamente a un control GridView.
	AutoGenerateEditButton	Obtiene o establece un valor que indica si una columna de campo CommandField con un botón Editar para cada fila de datos se agrega automáticamente a un control GridView.
	AutoGenerateSelectButton	Obtiene o establece un valor que indica si una columna de campo CommandField con un botón Seleccionar para cada fila de datos se agrega automáticamente a un control GridView.
	BackColor	Obtiene o establece el color de fondo del control de servidor web. (Se hereda de WebControl).
	BackImageUrl	Obtiene o establece la dirección URL de una imagen que se va a mostrar en el fondo de un control GridView.
	BindingContainer	Infraestructura. Obtiene el control que contiene el enlace de datos de este control. (Se hereda de Control).
	BorderColor	Obtiene o establece el color de borde del control Web. (Se hereda de WebControl).
	BorderStyle	Obtiene o establece el estilo del borde del control de servidor web. (Se hereda de WebControl).
	BorderWidth	Obtiene o establece el ancho del borde del control de servidor web. (Se hereda de WebControl).
	BottomPagerRow	Obtiene un objeto GridViewRow que representa la fila de paginación inferior de un control GridView.
	Caption	Obtiene o establece el texto que se va a representar en un elemento de título HTML de un control GridView. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda.
	CaptionAlign	Obtiene o establece la posición horizontal o vertical del elemento de título HTML de un control GridView. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda.
	CellPadding	Obtiene o establece la cantidad de espacio entre el contenido de una celda y el borde de la misma.
	CellSpacing	Obtiene o establece la cantidad de espacio entre las celdas.
	ChildControlsCreated	Obtiene un valor que indica si se han creado controles secundarios del control de servidor. (Se hereda de Control).
	ClientID	Obtiene el identificador de control del formato HTML generado por ASP.NET. (Se hereda de Control).
	ClientIDMode	Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID. (Se hereda de Control).
	ClientIDRowSuffix	Obtiene o establece los nombres de los campos de datos cuyos valores se anexan al valor de la propiedad ClientID para identificar de manera única cada instancia de un control enlazado a datos.
	ClientIDRowSuffixDataKeys	Infraestructura. Obtiene los valores de datos que se usan para identificar de manera única cada instancia de un control enlazado a datos cuando ASP.NET genera el valor de ClientID.
	ClientIDSeparator	Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Se hereda de Control).
	Columns	Obtiene una colección de objetos DataControlField que representan los campos de columna de un control GridView.
	ColumnsGenerator	Obtiene o establece el control que generará automáticamente las columnas para un control GridView que usa las características de datos dinámicos de ASP.NET.
	Context	Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Se hereda de Control).
	Controls	Obtiene una colección de los controles secundarios dentro del control enlazado a datos compuesto. (Se hereda de CompositeDataBoundControl).
	ControlStyle	Obtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
	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).
	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).
	DataItemContainer	Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Se hereda de Control).
	DataKeyNames	Obtiene o establece una matriz que contiene los nombres de los campos de clave principal de los elementos mostrados en un control GridView.
	DataKeys	Obtiene una colección de objetos DataKey que representan el valor de clave de los datos de cada fila de un control GridView.
	DataKeysContainer	Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Se hereda de Control).
	DataMember	Obtiene o establece el nombre de la lista de datos a la que se enlaza el control enlazado a datos, en los casos en que el origen de datos contiene más de una lista distinta de elementos de datos. (Se hereda de DataBoundControl).
	DataSource	Obtiene o establece el objeto del que el control enlazado a datos recupera su lista de elementos de datos. (Se hereda de BaseDataBoundControl).
	DataSourceID	Obtiene o establece el Id. del control del cual el control enlazado a datos recupera su lista de elementos de datos. (Se hereda de DataBoundControl).
	DataSourceObject	Obtiene un objeto que implementa la interfaz IDataSource, que proporciona acceso al contenido de datos del objeto. (Se hereda de DataBoundControl).
	DesignMode	Obtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Se hereda de Control).
	EditIndex	Obtiene o establece el índice de la fila que se va a editar.
	EditRowStyle	Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de la fila seleccionada para ser editada en un control GridView.
	EmptyDataRowStyle	Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de la fila de datos vacía que se representa cuando un control GridView se enlaza a un origen de datos que no contiene registros.
	EmptyDataTemplate	Obtiene o establece el contenido definido por el usuario para la fila de datos vacía que se representa cuando un control GridView se enlaza a un origen de datos que no contiene registros.
	EmptyDataText	Obtiene o establece el texto que se mostrará en la fila de datos vacía que se representa cuando un control GridView se enlaza a un origen de datos que no contiene registros.
	Enabled	Obtiene o establece un valor que indica si el control de servidor web está habilitado. (Se hereda de WebControl).
	EnableModelValidation	Obtiene o establece un valor que indica si un control de validación controlará las excepciones que se produzcan durante las operaciones de inserción o actualización.
	EnablePersistedSelection	Obtiene o establece un valor que indica si la selección de una fila se basa en los valores de índice o de clave de datos.
	EnableSortingAndPagingCallbacks	Obtiene o establece un valor que indica si se utilizan devoluciones de llamada de cliente para las operaciones de ordenación y paginación.
	EnableTheming	Obtiene o establece un valor que indica si los temas se aplican a este control. (Se hereda de WebControl).
	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).
	Events	Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Se hereda de Control).
	Font	Obtiene las propiedades de fuente asociadas al control de servidor web. (Se hereda de WebControl).
	FooterRow	Obtiene un objeto GridViewRow que representa la fila de pie de página de un control GridView.
	FooterStyle	Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de la fila de pie de página en un control GridView.
	ForeColor	Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web. (Se hereda de WebControl).
	GridLines	Obtiene o establece el estilo de cuadrícula de un control GridView.
	HasAttributes	Obtiene un valor que indica si el control tiene establecido algún atributo. (Se hereda de WebControl).
	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).
	HeaderRow	Obtiene un objeto GridViewRow que representa la fila de encabezado de un control GridView.
	HeaderStyle	Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de la fila de encabezado en un control GridView.
	Height	Obtiene o establece el alto del control de servidor Web. (Se hereda de WebControl).
	HorizontalAlign	Obtiene o establece la alineación horizontal de un control GridView en la página.
	ID	Obtiene o establece el identificador de programación asignado al control de servidor. (Se hereda de Control).
	IdSeparator	Infraestructura. Obtiene el carácter utilizado para separar los identificadores de control. (Se hereda de Control).
	Initialized	Obtiene un valor que indica si el control enlazado a datos está inicializado. (Se hereda de BaseDataBoundControl).
	IsBoundUsingDataSourceID	Obtiene un valor que indica si la propiedad DataSourceID está establecida. (Se hereda de BaseDataBoundControl).
	IsChildControlStateCleared	Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Se hereda de Control).
	IsEnabled	Obtiene un valor que indica si está habilitado el control. (Se hereda de WebControl).
	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).
	IsViewStateEnabled	Obtiene un valor que indica si el estado de vista está habilitado para este control. (Se hereda de Control).
	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).
	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).
	Page	Obtiene una referencia a la instancia Page que contiene el control de servidor. (Se hereda de Control).
	PageCount	Obtiene el número de páginas necesarias para mostrar los registros del origen de datos en un control GridView.
	PageIndex	Obtiene o establece el índice de la página que se muestra actualmente.
	PagerSettings	Obtiene una referencia al objeto PagerSettings que permite establecer las propiedades de los botones de paginación en un control GridView.
	PagerStyle	Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de la fila de paginación en un control GridView.
	PagerTemplate	Obtiene o establece el contenido personalizado de la fila de paginación de un control GridView.
	PageSize	Obtiene o establece el número de registros que se van a mostrar en una página de un control GridView.
	Parent	Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Se hereda de Control).
	RenderingCompatibility	Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Se hereda de Control).
	RequiresDataBinding	Obtiene o establece un valor que indica si se debe llamar al método DataBind. (Se hereda de BaseDataBoundControl).
	RowHeaderColumn	Obtiene o establece el nombre de la columna que se utilizará como encabezado de columna para el control GridView. Esta propiedad se proporciona de modo que el control sea más accesible para los usuarios de dispositivos de tecnología de ayuda.
	Rows	Obtiene una colección de objetos GridViewRow que representan las filas de datos de un control GridView.
	RowStyle	Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de las filas de datos alternas en un control GridView.
	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 DataBoundControl).
	SelectedDataKey	Obtiene el objeto DataKey que contiene el valor de la clave de datos para la fila seleccionada en un control GridView.
	SelectedIndex	Obtiene o establece el índice de la fila seleccionada en un control GridView.
	SelectedPersistedDataKey	Obtiene o establece el valor de la clave de datos del elemento seleccionado almacenado en un control GridView.
	SelectedRow	Obtiene una referencia a un objeto GridViewRow que representa la fila seleccionada en el control.
	SelectedRowStyle	Obtiene una referencia al objeto TableItemStyle que permite establecer la apariencia de la fila seleccionada en un control GridView.
	SelectedValue	Obtiene el valor de la clave de datos de la fila seleccionada en un control GridView.
	ShowFooter	Obtiene o establece un valor que indica si se muestra la fila de pie de página en un control GridView.
	ShowHeader	Obtiene o establece un valor que indica si se muestra la fila de encabezado en un control GridView.
	ShowHeaderWhenEmpty	Obtiene o establece un valor que indica si está visible el encabezado de una columna del control GridView cuando la columna no contiene datos.
	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).
	SkinID	Obtiene o establece la máscara que se va a aplicar al control. (Se hereda de WebControl).
	SortDirection	Obtiene el sentido de ordenación de la columna que se va a ordenar.
	SortedAscendingCellStyle	Obtiene o establece el estilo CSS de una columna de GridView cuando la columna está ordenada de manera ascendente.
	SortedAscendingHeaderStyle	Obtiene o establece el estilo CSS que se va a aplicar al encabezado de una columna de GridView cuando la columna está ordenada de manera ascendente.
	SortedDescendingCellStyle	Obtiene o establece el estilo de una columna de GridView cuando la columna está ordenada de manera descendente.
	SortedDescendingHeaderStyle	Obtiene o establece el estilo que se va a aplicar al encabezado de una columna de GridView cuando la columna está ordenada de manera descendente.
	SortExpression	Obtiene la expresión de ordenación asociada a la columna o columnas que se van a ordenar.
	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).
	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 BaseDataBoundControl).
	TabIndex	Obtiene o establece el índice de tabulación del control de servidor web. (Se hereda de WebControl).
	TagKey	Obtiene el valor de HtmlTextWriterTag para el control GridView. (Invalida a WebControl.TagKey).
	TagName	Obtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
	TemplateControl	Obtiene o establece una referencia a la plantilla que contiene este control. (Se hereda de Control).
	TemplateSourceDirectory	Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Se hereda de Control).
	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).
	TopPagerRow	Obtiene un objeto GridViewRow que representa la fila de paginación superior de un control GridView.
	UniqueID	Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Se hereda de Control).
	UseAccessibleHeader	Obtiene o establece un valor que indica si un control GridView representa 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.
	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).
	ViewStateIgnoresCase	Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Se hereda de Control).
	ViewStateMode	Obtiene o establece el modo del estado de vista de este control. (Se hereda de Control).
	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).
	Width	Obtiene o establece el ancho del control de servidor web. (Se hereda de WebControl).

Arriba

Métodos

	Nombre	Descripción
	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).
	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).
	AddParsedSubObject	Indica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega dicho elemento al objeto ControlCollection del control de servidor. (Se hereda de Control).
	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).
	ApplyStyleSheetSkin	Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página. (Se hereda de Control).
	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).
	ClearCachedClientID	Infraestructura. Establece en null el valor de ClientID almacenado en caché. (Se hereda de Control).
	ClearChildControlState	Elimina la información sobre el estado de control de los controles secundarios del control de servidor. (Se hereda de Control).
	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).
	ClearChildViewState	Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Se hereda de Control).
	ClearEffectiveClientIDMode	Infraestructura. Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Se hereda de Control).
	ConfirmInitState	Establece el estado inicializado del control enlazado a datos. (Se hereda de BaseDataBoundControl).
	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).
	CreateAutoGeneratedColumn	Crea un campo de columna generado automáticamente.
	CreateChildControls()	Infraestructura. Crea la jerarquía de controles que se utiliza para procesar un control compuesto enlazado a datos basada en los valores que se almacenan en estado de vista. (Se hereda de CompositeDataBoundControl).
	CreateChildControls(IEnumerable, Boolean)	Infraestructura. Crea la jerarquía de controles utilizada para representar el control GridView mediante el origen de datos especificado. (Invalida a CompositeDataBoundControl.CreateChildControls(IEnumerable, Boolean)).
	CreateChildTable	Infraestructura. Crea una nueva tabla secundaria.
	CreateColumns	Crea el conjunto de campos de columna utilizado para generar la jerarquía de controles.
	CreateControlCollection	Crea un nuevo objeto ControlCollection para guardar los controles secundarios (tanto literales como de servidor) del control de servidor. (Se hereda de Control).
	CreateControlStyle	Infraestructura. Crea el estilo predeterminado para el control. (Invalida a WebControl.CreateControlStyle()).
	CreateDataSourceSelectArguments	Crea el objeto DataSourceSelectArguments que contiene los argumentos que se pasan al origen de datos para su procesamiento. (Invalida a DataBoundControl.CreateDataSourceSelectArguments()).
	CreateRow	Crea una fila en el control GridView.
	DataBind()	Enlaza el origen de datos al control GridView. Este método no puede heredarse. (Invalida a BaseDataBoundControl.DataBind()).
	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).
	DataBindChildren	Enlaza un origen de datos a los controles secundarios del control de servidor. (Se hereda de Control).
	DeleteRow	Elimina el registro en el índice especificado del origen de datos.
	Dispose	Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Se hereda de Control).
	EnsureChildControls	Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Se hereda de Control).
	EnsureDataBound	Llama al método DataBind si se establece la propiedad DataSourceID y el control enlazado a datos está marcado de forma que requiera el enlace. (Se hereda de BaseDataBoundControl).
	EnsureID	Crea un identificador para controles que no tiene un identificador asignado. (Se hereda de Control).
	Equals(Object)	Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
	ExtractRowValues	Recupera los valores de cada campo declarado dentro de la fila especificada y los almacena en el objeto IOrderedDictionary especificado.
	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).
	FindControl(String)	Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual. (Se hereda de Control).
	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).
	Focus	Establece el foco de entrada en un control. (Se hereda de Control).
	GetCallbackResult	Devuelve el resultado de un evento de devolución de llamada que tiene como destino un control.
	GetCallbackScript	Crea el script de devolución de llamada para un botón que realiza una operación de ordenación.
	GetData	Recupera un objeto DataSourceView que utiliza el control enlazado a datos para realizar operaciones con los datos. (Se hereda de DataBoundControl).
	GetDataSource	Recupera la interfaz IDataSource a la que se asocia el control enlazado a datos, si existe. (Se hereda de DataBoundControl).
	GetDesignModeState	Infraestructura. Obtiene datos en tiempo de diseño para un control. (Se hereda de Control).
	GetHashCode	Actúa como función hash para un tipo concreto. (Se hereda de Object).
	GetRouteUrl(Object)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
	GetRouteUrl(RouteValueDictionary)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
	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).
	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).
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	GetUniqueIDRelativeTo	Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Se hereda de Control).
	HasControls	Determina si el control de servidor contiene controles secundarios. (Se hereda de Control).
	HasEvents	Devuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Se hereda de Control).
	InitializePager	Inicializa la fila de paginación que se muestra cuando se habilita la característica de paginación.
	InitializeRow	Inicializa una fila del control GridView.
	IsBindableType	Determina si el tipo de datos especificado se puede enlazar a una columna en un control GridView.
	IsLiteralContent	Infraestructura. Determina si el control de servidor alberga únicamente contenido literal. (Se hereda de Control).
	LoadControlState	Infraestructura. Carga el estado de las propiedades del control GridView que deben conservarse, incluso cuando la propiedad Control.EnableViewState se establece en false. (Invalida a Control.LoadControlState(Object)).
	LoadViewState	Carga el estado de vista previamente guardado del control GridView. (Invalida a WebControl.LoadViewState(Object)).
	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).
	MarkAsDataBound	Establece el estado del control en estado de vista como enlazado correctamente a los datos. (Se hereda de DataBoundControl).
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	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).
	OnBubbleEvent	Determina si el evento del control de servidor Web debe pasarse a la jerarquía de controles de servidor de la interfaz de usuario (UI) de la página. (Invalida a Control.OnBubbleEvent(Object, EventArgs)).
	OnDataBinding	Provoca el evento DataBinding. (Se hereda de Control).
	OnDataBound	Provoca el evento DataBound. (Se hereda de BaseDataBoundControl).
	OnDataPropertyChanged	Vuelve a enlazar el control GridView a sus datos después de cambiar la propiedad DataMember, DataSource o DataSourceID. (Invalida a DataBoundControl.OnDataPropertyChanged()).
	OnDataSourceViewChanged	Genera el evento DataSourceViewChanged. (Invalida a DataBoundControl.OnDataSourceViewChanged(Object, EventArgs)).
	OnInit	Provoca el evento Control.Init. (Invalida a BaseDataBoundControl.OnInit(EventArgs)).
	OnLoad	Controla el evento Control.Load. (Se hereda de DataBoundControl).
	OnPageIndexChanged	Provoca el evento PageIndexChanged.
	OnPageIndexChanging	Provoca el evento PageIndexChanging.
	OnPagePreLoad	Establece el estado inicializado del control enlazado a datos antes de cargar el control. (Invalida a DataBoundControl.OnPagePreLoad(Object, EventArgs)).
	OnPreRender	Infraestructura. Provoca el evento PreRender. (Invalida a BaseDataBoundControl.OnPreRender(EventArgs)).
	OnRowCancelingEdit	Provoca el evento RowCancelingEdit.
	OnRowCommand	Provoca el evento RowCommand.
	OnRowCreated	Genera el evento RowCreated.
	OnRowDataBound	Genera el evento RowDataBound.
	OnRowDeleted	Provoca el evento RowDeleted.
	OnRowDeleting	Provoca el evento RowDeleting.
	OnRowEditing	Provoca el evento RowEditing.
	OnRowUpdated	Provoca el evento RowUpdated.
	OnRowUpdating	Provoca el evento RowUpdating.
	OnSelectedIndexChanged	Provoca el evento SelectedIndexChanged.
	OnSelectedIndexChanging	Genera el evento SelectedIndexChanging.
	OnSorted	Provoca el evento Sorted.
	OnSorting	Provoca el evento Sorting.
	OnUnload	Provoca el evento Unload. (Se hereda de Control).
	OpenFile	Obtiene un objeto Stream utilizado para leer un archivo. (Se hereda de Control).
	PerformDataBinding	Infraestructura. Enlaza el origen de datos especificado al control GridView. (Invalida a CompositeDataBoundControl.PerformDataBinding(IEnumerable)).
	PerformSelect	Recupera los datos del origen de datos asociado. (Se hereda de DataBoundControl).
	PrepareControlHierarchy	Infraestructura. Establece la jerarquía de controles.
	RaiseBubbleEvent	Asigna los orígenes del evento y su información al control principal del control. (Se hereda de Control).
	RaiseCallbackEvent	Crea los argumentos para el controlador de devolución de llamada en el método GetCallbackEventReference.
	RaisePostBackEvent	Provoca los eventos correspondientes para el control GridView cuando devuelve datos al servidor.
	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).
	Render	Infraestructura. Representa el contenido del control de servidor Web en el explorador del cliente por medio del objeto System.Web.UI.HtmlTextWriter especificado. (Invalida a WebControl.Render(HtmlTextWriter)).
	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).
	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).
	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).
	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).
	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).
	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).
	ResolveAdapter	Obtiene el adaptador de controles que se encarga de representar el control especificado. (Se hereda de Control).
	ResolveClientUrl	Obtiene una dirección URL que el explorador puede utilizar. (Se hereda de Control).
	ResolveUrl	Convierte una dirección URL en una que el cliente solicitante pueda utilizar. (Se hereda de Control).
	SaveControlState	Infraestructura. Guarda el estado de las propiedades del control GridView que deben conservarse, incluso cuando la propiedad Control.EnableViewState se establece en false. (Invalida a Control.SaveControlState()).
	SaveViewState	Infraestructura. Carga el estado de vista previamente guardado del control GridView. (Invalida a WebControl.SaveViewState()).
	SelectRow	Selecciona la fila que se va a editar en un control GridView.
	SetDesignModeState	Establece datos en tiempo de diseño para un control. (Se hereda de Control).
	SetEditRow	Pone una fila en modo de edición en un control GridView usando el índice de fila especificado.
	SetPageIndex	Establece el índice de página del control GridView usando el índice de fila.
	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).
	Sort	Ordena el control GridView según la expresión y el sentido de ordenación especificados.
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
	TrackViewState	Infraestructura. Realiza el seguimiento de los cambios del estado de vista para el control GridView para poder almacenarlos en el objeto System.Web.UI.StateBag del control. Se obtiene acceso a este objeto a través de la propiedad Control.ViewState. (Invalida a WebControl.TrackViewState()).
	UpdateRow	Actualiza el registro en el índice de fila especificado utilizando los valores de campo de la fila.
	ValidateDataSource	Comprueba que el objeto al que se enlaza un control enlazado a datos es compatible. (Se hereda de DataBoundControl).

Arriba

Eventos

	Nombre	Descripción
	DataBinding	Se produce cuando el control de servidor se enlaza a un origen de datos. (Se hereda de Control).
	DataBound	Se produce después de que el control de servidor se enlaza a un origen de datos. (Se hereda de BaseDataBoundControl).
	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).
	Init	Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Se hereda de Control).
	Load	Se produce cuando el control de servidor se carga en el objeto Page. (Se hereda de Control).
	PageIndexChanged	Se produce cuando se hace clic en uno de los botones de paginación, pero después de que el control GridView se ocupe de la operación de paginación.
	PageIndexChanging	Se produce cuando se hace clic en uno de los botones de paginación, pero antes de que el control GridView se ocupe de la operación de paginación.
	PreRender	Se produce una vez que se carga el objeto Control, pero antes de su representación. (Se hereda de Control).
	RowCancelingEdit	Se produce cuando se hace clic en el botón Cancelar de una fila en modo de edición, pero antes de que la fila salga del modo de edición.
	RowCommand	Se produce cuando se hace clic en un botón de un control GridView.
	RowCreated	Se produce cuando se crea una fila en un control GridView.
	RowDataBound	Se produce cuando una fila de datos se enlaza a los datos de un control GridView.
	RowDeleted	Se produce cuando se hace clic en el botón Eliminar de una fila, pero después de que el control GridView elimine la fila.
	RowDeleting	Se produce cuando se hace clic en el botón Eliminar de una fila, pero antes de que el control GridView elimine la fila.
	RowEditing	Se produce cuando se hace clic en el botón Editar de una fila, pero antes de que el control GridView entre en el modo de edición.
	RowUpdated	Se produce cuando se hace clic en el botón Actualizar de una fila, pero después de que el control GridView actualice la fila.
	RowUpdating	Se produce cuando se hace clic en el botón Actualizar de una fila, pero antes de que el control GridView actualice la fila.
	SelectedIndexChanged	Se produce cuando se hace clic en el botón Seleccionar de una fila, pero después de que el control GridView se ocupe de la operación de selección.
	SelectedIndexChanging	Se produce cuando se hace clic en el botón Seleccionar de una fila, pero antes de que el control GridView se ocupe de la operación de selección.
	Sorted	Se produce cuando se hace clic en el hipervínculo para ordenar una columna, pero después de que el control GridView se ocupe de la operación de ordenación.
	Sorting	Se produce cuando se hace clic en el hipervínculo para ordenar una columna, pero antes de que el control GridView se ocupe de la operación de ordenación.
	Unload	Se produce cuando el control de servidor se descarga de la memoria. (Se hereda de Control).

Arriba

Métodos de extensión

	Nombre	Descripción
	EnablePersistedSelection	Permite conservar la selección en los controles de datos que admiten la selección y paginación. (Definido por DynamicDataExtensions).
	FindDataSourceControl	Devuelve el origen de datos que está asociado al control de datos del control especificado. (Definido por DynamicDataExtensions).
	FindFieldTemplate	Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado. (Definido por DynamicDataExtensions).
	FindMetaTable	Devuelve el objeto de metatabla para el control de datos contenedor. (Definido por DynamicDataExtensions).

Arriba

Implementaciones explícitas de interfaces

	Nombre	Descripción
	IAttributeAccessor.GetAttribute	Infraestructura. Obtiene un atributo del control Web con el nombre especificado. (Se hereda de WebControl).
	IAttributeAccessor.SetAttribute	Establece un atributo del control Web con el nombre y el valor especificados. (Se hereda de WebControl).
	ICallbackContainer.GetCallbackScript	Infraestructura. Crea el script de devolución de llamada para un botón que realiza una operación de ordenación.
	ICallbackEventHandler.GetCallbackResult	Infraestructura. Devuelve el resultado de un evento de devolución de llamada que tiene como destino un control.
	ICallbackEventHandler.RaiseCallbackEvent	Infraestructura. Crea los argumentos para el controlador de devolución de llamada en el método GetCallbackEventReference.
	IControlBuilderAccessor.ControlBuilder	Para obtener una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder. (Se hereda de Control).
	IControlDesignerAccessor.GetDesignModeState	Para obtener una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState. (Se hereda de Control).
	IControlDesignerAccessor.SetDesignModeState	Para obtener una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState. (Se hereda de Control).
	IControlDesignerAccessor.SetOwnerControl	Infraestructura. Para obtener una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl. (Se hereda de Control).
	IControlDesignerAccessor.UserData	Para obtener una descripción de este miembro, vea IControlDesignerAccessor.UserData. (Se hereda de Control).
	IDataBindingsAccessor.DataBindings	Para obtener una descripción de este miembro, vea IDataBindingsAccessor.DataBindings. (Se hereda de Control).
	IDataBindingsAccessor.HasDataBindings	Para obtener una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings. (Se hereda de Control).
	IDataBoundControl.DataKeyNames	Obtiene o establece los nombres de los campos de clave principal de los elementos que se muestran en un control enlazado a datos.
	IDataBoundControl.DataMember	Obtiene o establece la tabla expuesta por el control de origen de datos que se va a enlazar al control enlazado a datos.
	IDataBoundControl.DataSource	Obtiene o establece el objeto de origen de datos del que el control enlazado a datos recupera la lista de elementos de datos.
	IDataBoundControl.DataSourceID	Obtiene o establece el identificador del origen de datos del que el control enlazado a datos recupera la lista de elementos de datos.
	IDataBoundControl.DataSourceObject	Obtiene o establece el objeto de origen de datos del que el control enlazado a datos recupera la lista de elementos de datos.
	IDataBoundListControl.ClientIDRowSuffix	Obtiene o establece los nombres de los campos de datos cuyos valores se anexan al valor de la propiedad ClientID para identificar de manera única cada instancia de un control enlazado a datos.
	IDataBoundListControl.DataKeys	Obtiene una colección de los objetos que representan el valor de DataKeys de un control enlazado a datos.
	IDataBoundListControl.EnablePersistedSelection	Obtiene o establece un valor que indica si la selección de una fila se basa en los valores de índice o de clave de datos.
	IDataBoundListControl.SelectedDataKey	Obtiene el objeto que contiene el valor de la clave de datos de la fila seleccionada en un control enlazado a datos.
	IDataBoundListControl.SelectedIndex	Obtiene o establece el índice de la fila seleccionada en el control enlazado a datos.
	IDataKeysControl.ClientIDRowSuffixDataKeys	Infraestructura. Obtiene los valores de datos que se usan para identificar de manera única cada instancia de un control enlazado a datos cuando ASP.NET genera el valor de ClientID.
	IExpressionsAccessor.Expressions	Para obtener una descripción de este miembro, vea IExpressionsAccessor.Expressions. (Se hereda de Control).
	IExpressionsAccessor.HasExpressions	Para obtener una descripción de este miembro, vea IExpressionsAccessor.HasExpressions. (Se hereda de Control).
	IFieldControl.FieldsGenerator	Obtiene o establece el control que genera automáticamente las columnas de un control enlazado a datos que van a usar los datos dinámicos de ASP.NET.
	IParserAccessor.AddParsedSubObject	Para obtener una descripción de este miembro, vea IParserAccessor.AddParsedSubObject. (Se hereda de Control).
	IPersistedSelector.DataKey	Para obtener una descripción de este miembro, vea IPersistedSelector.DataKey.
	IPostBackContainer.GetPostBackOptions	Infraestructura. Crea un objeto PostBackOptions que representa el comportamiento de la devolución de datos del control de botón especificado.
	IPostBackEventHandler.RaisePostBackEvent	Infraestructura. Provoca los eventos correspondientes para el control GridView cuando devuelve datos al servidor.

Arriba

Comentarios

En este tema:

Introduction
Campos de columna
Enlace a datos
Operaciones de datos
Personalizar la interfaz de usuario
Eventos
Accesibilidad
Sintaxis de la declaración

Introduction

El control GridView se utiliza para mostrar los valores de un origen de datos en una tabla. Cada columna representa un campo y cada fila representa un registro. El control GridView admite las características siguientes:

Enlace a controles de origen de datos, como SqlDataSource.
Funciones de ordenación integradas.
Funciones de actualización y eliminación integradas.
Funciones de paginación integradas.
Funciones de selección de fila integradas.
Acceso mediante programación al modelo de objetos GridView para establecer propiedades dinámicamente, controlar eventos, etc.
Varios campos de clave.
Varios campos de datos para las columnas de hipervínculo.
Personalización de la apariencia a través de temas y estilos.
Para obtener información sobre el resto de los controles enlazados a datos disponibles en ASP.NET, vea Información general sobre los controles de servidor web ASP.NET enlazados a datos.

Nota
Si está familiarizado con el control DataGrid de la versión 1.0 de .NET Framework, el control GridView es el sucesor del control DataGrid.

Campos de columna

Un objeto DataControlField representa cada columna del control GridView. De manera predeterminada, la propiedad AutoGenerateColumns se establece en true, lo que crea un objeto AutoGeneratedField para cada campo del origen de datos. A continuación, cada campo se representa como una columna del control GridView en el orden de aparición de cada campo en el origen de datos.

También puede controlar manualmente qué campos de columna aparecen en el control GridView; para ello, establezca la propiedad AutoGenerateColumns en false y defina después su propia colección de campos de columna. Los distintos tipos de campo de columna determinan el comportamiento de las columnas del control. La siguiente tabla contiene los diferentes tipos de campos de columna que se pueden utilizar.

Tipo de campo de columna	Descripción
BoundField	Muestra el valor de un campo en un origen de datos. Éste es el tipo de columna predeterminado del control GridView.
ButtonField	Muestra un botón de comando para cada elemento del control GridView. Esto permite crear una columna de controles de botón personalizados, como el botón Agregar o Quitar.
CheckBoxField	Muestra una casilla para cada elemento del control GridView. Normalmente, este tipo de campo de columna se utiliza para mostrar los campos con un valor booleano.
CommandField	Muestra los botones de comando predefinidos para realizar operaciones de selección, edición o eliminación.
HyperLinkField	Muestra el valor de un campo de un origen de datos como un hipervínculo. Este tipo de campo de columna permite enlazar un segundo campo a la dirección URL del hipervínculo.
ImageField	Muestra una imagen para cada elemento del control GridView.
TemplateField	Muestra el contenido definido por el usuario para cada elemento del control GridView según una plantilla especificada. Este tipo de campo de columna permite crear un campo de columna personalizado.

Para definir una colección de campos de columna mediante declaración, primero agregue etiquetas <Columns> de apertura y cierre entre las etiquetas de apertura y cierre del control GridView. Luego, muestre los campos de columna que desea incluir entre las etiquetas <Columns> de apertura y cierre. Las columnas especificadas se agregan a la colección Columns en el orden en que aparecen en la lista. La colección Columns almacena todos los campos de columna del control y permite administrar los campos de columna del control GridView mediante programación.

Los campos de columna declarados explícitamente se pueden mostrar junto con los campos de columna generados automáticamente. Cuando se utilizan ambos, primero se representan los campos de columna declarados explícitamente, seguidos de los campos de columna generados automáticamente.

Nota
Los campos de columna generados automáticamente no se agregan a la colección Columns.

Enlace a datos

El control GridView se puede enlazar a un control de origen de datos (como el control SqlDataSource o el control ObjectDataSource) o a cualquier colección de orígenes de datos que implemente la interfaz System.Collections.IEnumerable, como System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>, u otros tipos de colección. Utilice uno de los métodos siguientes para enlazar el control GridView al tipo de origen de datos adecuado:

Para enlazar a un control de origen de datos, establezca la propiedad DataSourceID del control GridView en el valor ID del control de origen de datos. El control GridView se enlaza automáticamente al control de origen de datos especificado y puede sacar partido de las funciones del control de origen de datos para realizar operaciones de ordenación, actualización, eliminación y paginación. Éste es el método recomendado para el enlace a datos.
Para enlazar a un origen de datos que implementa la interfaz System.Collections.IEnumerable, establezca mediante programación la propiedad DataSource del control GridView en el origen de datos y, a continuación, llame al método DataBind. Al utilizar este método, el control GridView no ofrece funcionalidad integrada de ordenación, actualización, eliminación y paginación. Para ofrecer esta funcionalidad, deberá utilizar el evento correspondiente.

Para obtener más información sobre el enlace de datos, vea Acceso a datos de ASP.NET.

Nota
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. Siempre que sea posible, se recomienda encarecidamente codificar los valores mediante HTML antes de mostrarlos en este control (la clase BoundField codifica los valores mediante HTML de manera predeterminada). 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 Introduction to the Validation Controls.

Nota

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. Siempre que sea posible, se recomienda encarecidamente codificar los valores mediante HTML antes de mostrarlos en este control (la clase BoundField codifica los valores mediante HTML de manera predeterminada). 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 Introduction to the Validation Controls.

Operaciones de datos

El control GridView proporciona muchas funciones integradas que permiten al usuario ordenar, actualizar, eliminar, seleccionar y recorrer página a página los elementos del control. Cuando el control GridView se enlaza a un control de origen de datos, el control GridView puede aprovechar la funcionalidad de ese control y proporcionar funcionalidad de ordenación automática, actualización y eliminación.

Nota
El control GridView puede proporcionar compatibilidad para ordenar, actualizar y eliminar con otros tipos de orígenes de datos. Sin embargo, tendrá que proporcionar un controlador de eventos adecuado a la implementación para estas operaciones.

La ordenación permite al usuario ordenar los elementos del control GridView respecto a una columna concreta al hacer clic en el encabezado de la columna. Para habilitar la ordenación, establezca la propiedad AllowSorting en true.

Las funciones de actualización automática, eliminación y selección se habilitan cuando se hace clic en un botón de un campo de columna ButtonField o TemplateField cuyo nombre de comando sea "Editar", "Eliminar" y "Seleccionar". El control GridView puede agregar un campo de columna CommandField automáticamente con un botón Editar, Eliminar o Seleccionar si la propiedad AutoGenerateEditButton, AutoGenerateDeleteButton o AutoGenerateSelectButton, respectivamente, se establece en true.

Nota
El control GridView no admite directamente la inserción de registros en el origen de datos. Sin embargo, es posible insertar registros si se utiliza el control GridView junto con el control DetailsView o FormView. Para obtener más información, vea DetailsView o FormView, respectivamente.

En lugar de mostrar todos los registros del origen de datos al mismo tiempo, el control GridView puede repartir los registros entre varias páginas automáticamente. Para habilitar la paginación, establezca la propiedad AllowPaging en true.

Nota
El control GridView se vuelve a crear en la devolución de datos en función de la información almacenada en ViewState. Si el control GridView incluye un TemplateField o CommandField cuya propiedad CausesValidation está establecida en true, la propiedad EnableViewState debe ser también true para garantizar que las operaciones de datos simultáneas, como actualizaciones y eliminaciones, se apliquen a la fila adecuada.

Nota

El control GridView se vuelve a crear en la devolución de datos en función de la información almacenada en ViewState. Si el control GridView incluye un TemplateField o CommandField cuya propiedad CausesValidation está establecida en true, la propiedad EnableViewState debe ser también true para garantizar que las operaciones de datos simultáneas, como actualizaciones y eliminaciones, se apliquen a la fila adecuada.

Personalizar la interfaz de usuario

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

Propiedad de estilo	Descripción
AlternatingRowStyle	Configuración de estilo de las filas de datos alternas del control GridView. Cuando se establece esta propiedad, las filas de datos se muestran alternando la configuración de RowStyle y la configuración de AlternatingRowStyle.
EditRowStyle	Configuración de estilo de la fila que se edita en el control GridView.
EmptyDataRowStyle	Configuración de estilo de la fila de datos vacía que se muestra en el control GridView cuando el origen de datos no contiene registros.
FooterStyle	Configuración de estilo de la fila del pie de página del control GridView.
HeaderStyle	Configuración de estilo de la fila del encabezado del control GridView.
PagerStyle	Configuración de estilo de la fila de paginación del control GridView.
RowStyle	Configuración de estilo de las filas de datos del control GridView. Cuando también se establece la propiedad AlternatingRowStyle, las filas de datos se muestran alternando la configuración de RowStyle y la configuración de AlternatingRowStyle.
SelectedRowStyle	Configuración de estilo de la fila seleccionada en el control GridView.
SortedAscendingCellStyle	La configuración de estilo para la columna de datos por la que se ordenan los datos en el control GridView. Cuando se establece este estilo, el estilo (por ejemplo, columna resaltada) se aplica a las celdas cuando se ordenan los datos de forma ascendente.
SortedAscendingHeaderStyle	La configuración de estilo para la columna de datos por la que se ordenan los datos en el control GridView. Cuando se establece este estilo, una flecha indicando que los datos están ordenados de forma ascendente se coloca en el encabezado del control GridView cuando los datos se ordenan de forma ascendente.
SortedDescendingCellStyle	La configuración de estilo para la columna de datos por la que se ordenan los datos en el control GridView. Cuando se establece este estilo, el estilo (por ejemplo, columna resaltada) se aplica a las celdas cuando se ordenan los datos de forma descendente.
SortedDescendingHeaderStyle	La configuración de estilo para la columna de datos por la que se ordenan los datos en el control GridView. Cuando se establece este estilo, se sitúa una flecha que apunta hacia abajo en el encabezado de GridView cuando los datos se ordenan de forma descendente.

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 GridView.
ShowHeader	Muestra u oculta la sección de encabezado del control GridView.

Eventos

El control GridView proporciona varios eventos que puede utilizar para programar. De esta manera, se puede ejecutar una rutina personalizada siempre que se provoque un evento. En la siguiente tabla se enumeran los eventos admitidos por el control GridView.

Evento	Descripción
PageIndexChanged	Se produce cuando se hace clic en uno de los botones de paginación, pero después de que el control GridView se ocupe de la operación de paginación. Normalmente se utiliza este evento cuando es necesario realizar una tarea después de que el usuario navega a una página diferente en el control.
PageIndexChanging	Se produce cuando se hace clic en uno de los botones de paginación, pero antes de que el control GridView se ocupe de la operación de paginación. Este evento suele utilizarse para cancelar la operación de paginación.
RowCancelingEdit	Se produce cuando se hace clic en el botón Cancelar de una fila, pero antes de que el control GridView salga del modo de edición. Este evento suele utilizarse para detener la operación de cancelación.
RowCommand	Se desencadena cuando se hace clic en un botón del control GridView. Este evento se utiliza normalmente para realizar una tarea cuando se hace clic en un botón del control.
RowCreated	Se desencadena cuando se crea una nueva fila en el control GridView. Este evento se utiliza a menudo para modificar el contenido de una fila en el momento de su creación.
RowDataBound	Se produce cuando una fila de datos se enlaza a los datos del control GridView. Este evento se utiliza a menudo para modificar el contenido de una fila cuando ésta se enlaza a datos.
RowDeleted	Se produce cuando se hace clic en el botón Eliminar de una fila, pero después de que el control GridView elimine el registro del origen de datos. Este evento suele utilizarse para comprobar el resultado de la operación de eliminación.
RowDeleting	Se produce cuando se hace clic en el botón Eliminar de una fila, pero antes de que el control GridView elimine el registro del origen de datos. Este evento suele utilizarse para cancelar la operación de eliminación.
RowEditing	Se produce cuando se hace clic en el botón Editar de una fila, pero antes de que el control GridView entre en el modo de edición. Este evento suele utilizarse para cancelar la operación de edición.
RowUpdated	Se produce cuando se hace clic en el botón Actualizar de una fila, pero después de que el control GridView actualice la fila. Este evento se utiliza normalmente para comprobar los resultados de la operación de actualización.
RowUpdating	Se produce cuando se hace clic en el botón Actualizar de una fila, pero antes de que el control GridView actualice la fila. Este evento suele utilizarse para cancelar la operación de actualización.
SelectedIndexChanged	Se produce cuando se hace clic en el botón Seleccionar de una fila, pero después de que el control GridView se ocupe de la operación de selección. Este evento se utiliza a menudo para realizar una tarea después de que se selecciona una fila en el control.
SelectedIndexChanging	Se produce cuando se hace clic en el botón Seleccionar de una fila, pero antes de que el control GridView se ocupe de la operación de selección. Este evento suele utilizarse para cancelar la operación de selección.
Sorted	Se produce cuando se hace clic en el hipervínculo para ordenar una columna, pero después de que el control GridView se ocupe de la operación de ordenación. Este evento se utiliza normalmente para realizar una tarea después de que el usuario hace clic en un hipervínculo para ordenar una columna.
Sorting	Se produce cuando se hace clic en el hipervínculo para ordenar una columna, pero antes de que el control GridView se ocupe de la operación de ordenación. Este evento se utiliza a menudo para cancelar la operación de ordenación o realizar una rutina de ordenación personalizada.

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:GridView
    AccessKey="string"
    AllowPaging="True|False"
    AllowSorting="True|False"
    AutoGenerateColumns="True|False"
    AutoGenerateDeleteButton="True|False"
    AutoGenerateEditButton="True|False"
    AutoGenerateSelectButton="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"
    DataKeyNames="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditIndex="integer"
    EmptyDataText="string"
    Enabled="True|False"
    EnableSortingAndPagingCallbacks="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"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPageIndexChanging="PageIndexChanging event handler"
    OnPreRender="PreRender event handler"
    OnRowCancelingEdit="RowCancelingEdit event handler"
    OnRowCommand="RowCommand event handler"
    OnRowCreated="RowCreated event handler"
    OnRowDataBound="RowDataBound event handler"
    OnRowDeleted="RowDeleted event handler"
    OnRowDeleting="RowDeleting event handler"
    OnRowEditing="RowEditing event handler"
    OnRowUpdated="RowUpdated event handler"
    OnRowUpdating="RowUpdating event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnSelectedIndexChanging="SelectedIndexChanging event handler"
    OnSorted="Sorted event handler"
    OnSorting="Sorting event handler"
    OnUnload="Unload event handler"
    PageIndex="integer"
    PagerSettings-FirstPageImageUrl="uri"
    PagerSettings-FirstPageText="string"
    PagerSettings-LastPageImageUrl="uri"
    PagerSettings-LastPageText="string"
    PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|
        NumericFirstLast"
    PagerSettings-NextPageImageUrl="uri"
    PagerSettings-NextPageText="string"
    PagerSettings-PageButtonCount="integer"
    PagerSettings-Position="Bottom|Top|TopAndBottom"
    PagerSettings-PreviousPageImageUrl="uri"
    PagerSettings-PreviousPageText="string"
    PagerSettings-Visible="True|False"
    PageSize="integer"
    RowHeaderColumn="string"
    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"
>
        <AlternatingRowStyle />
        <Columns>
                <asp:BoundField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundField>
                <asp:ButtonField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ImageUrl="uri"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonField>
                <asp:CheckBoxField
                    AccessibleHeaderText="string"
                    DataField="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CheckBoxField>
                <asp:CommandField
                    AccessibleHeaderText="string"
                    ButtonType="Button|Image|Link"
                    CancelImageUrl="uri"
                    CancelText="string"
                    CausesValidation="True|False"
                    DeleteImageUrl="uri"
                    DeleteText="string"
                    EditImageUrl="uri"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertImageUrl="uri"
                    InsertText="string"
                    InsertVisible="True|False"
                    NewImageUrl="uri"
                    NewText="string"
                    SelectImageUrl="uri"
                    SelectText="string"
                    ShowCancelButton="True|False"
                    ShowDeleteButton="True|False"
                    ShowEditButton="True|False"
                    ShowHeader="True|False"
                    ShowInsertButton="True|False"
                    ShowSelectButton="True|False"
                    SortExpression="string"
                    UpdateImageUrl="uri"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:CommandField>
                <asp:DynamicField
                    AccessibleHeaderText="string"
                    ApplyFormatInEditMode="True|False"
                    ConvertEmptyStringToNull="True|False"
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    HtmlEncode="True|False"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    ShowHeader="True|False"
                    UIHint="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:DynamicField>
                <asp:HyperLinkField
                    AccessibleHeaderText="string"
                    DataNavigateUrlFields="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NavigateUrl="uri"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkField>
                <asp:ImageField
                    AccessibleHeaderText="string"
                    AlternateText="string"
                    ConvertEmptyStringToNull="True|False"
                    DataAlternateTextField="string"
                    DataAlternateTextFormatString="string"
                    DataImageUrlField="string"
                    DataImageUrlFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    NullDisplayText="string"
                    NullImageUrl="uri"
                    ReadOnly="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <ControlStyle />
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ImageField>
                <asp:TemplateField
                    AccessibleHeaderText="string"
                    ConvertEmptyStringToNull="True|False"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    InsertVisible="True|False"
                    ShowHeader="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                            <ControlStyle />
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <AlternatingItemTemplate>
                            <!-- child controls -->
                        </AlternatingItemTemplate>
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <InsertItemTemplate>
                            <!-- child controls -->
                        </InsertItemTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateField>
        </Columns>
        <EditRowStyle />
        <EmptyDataRowStyle />
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <FooterStyle />
        <HeaderStyle />
        <PagerSettings
            FirstPageImageUrl="uri"
            FirstPageText="string"
            LastPageImageUrl="uri"
            LastPageText="string"
            Mode="NextPrevious|Numeric|NextPreviousFirstLast|
                NumericFirstLast"
            NextPageImageUrl="uri"
            NextPageText="string"
            OnPropertyChanged="PropertyChanged event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PreviousPageImageUrl="uri"
            PreviousPageText="string"
            Visible="True|False"
        />
        <PagerStyle />
        <PagerTemplate>
            <!-- child controls -->
        </PagerTemplate>
        <RowStyle />
        <SelectedRowStyle />
</asp:GridView>

Ejemplos

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

En el ejemplo de código siguiente se indica cómo utilizar el control GridView para mostrar los valores de la tabla Customers de la base de datos de ejemplo AdventureWorksLT en Microsoft SQL Server. Los valores se recuperan mediante un control SqlDataSource.

Copiar


<asp:sqldatasource id="CustomersSource"
  selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer"
  connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>" 
  runat="server"/>

<asp:gridview id="CustomersGridView" 
  datasourceid="CustomersSource" 
  autogeneratecolumns="False"
  emptydatatext="No data available." 
  allowpaging="True" 
  runat="server" DataKeyNames="CustomerID">
    <Columns>
        <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
            InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" />
        <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" 
            SortExpression="CompanyName" />
        <asp:BoundField DataField="FirstName" HeaderText="FirstName" 
            SortExpression="FirstName" />
        <asp:BoundField DataField="LastName" HeaderText="LastName" 
            SortExpression="LastName" />
    </Columns>
</asp:gridview>

El siguiente ejemplo muestra cómo utilizar el control GridView y un control LinqDataSource para que pueda modificar los registros.

Copiar


<asp:LinqDataSource ID="LinqDataSource1" runat="server" 
    ContextTypeName="AdventureWorksLTDataClassesDataContext"
    EnableDelete="True" EnableInsert="True" EnableUpdate="True" 
    TableName="SalesOrderDetails">
</asp:LinqDataSource>

<asp:GridView ID="GridView1" runat="server" 
    AutoGenerateColumns="False" 
    DataKeyNames="SalesOrderID,SalesOrderDetailID"
    DataSourceID="LinqDataSource1">
    <Columns>
        <asp:CommandField ShowDeleteButton="True" 
            ShowEditButton="True" />
        <asp:BoundField DataField="SalesOrderID" 
            HeaderText="SalesOrderID" ReadOnly="True"
            SortExpression="SalesOrderID" />
        <asp:BoundField DataField="SalesOrderDetailID" 
            HeaderText="SalesOrderDetailID" InsertVisible="False"
            ReadOnly="True" SortExpression="SalesOrderDetailID" />
        <asp:BoundField DataField="OrderQty" 
            HeaderText="OrderQty" SortExpression="OrderQty" />
        <asp:BoundField DataField="ProductID" 
            HeaderText="ProductID" SortExpression="ProductID" />
        <asp:BoundField DataField="UnitPrice" 
            HeaderText="UnitPrice" SortExpression="UnitPrice" />
        <asp:BoundField DataField="ModifiedDate" 
            HeaderText="ModifiedDate" SortExpression="ModifiedDate" />
    </Columns>
</asp:GridView>

Para obtener un ejemplo de en el que se muestre cómo tener acceso a los valores de las celdas, vea GridViewRow.

Información de versión

.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

Plataformas

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.

Seguridad para subprocesos

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.

Vea también

Historial de cambios

Fecha	Historial	Motivo
Julio de 2008	Se han agregado nuevos miembros: las propiedades ColumnsGenerator, EnableModelValidation, SelectedPersistedDataKey y IPersistedSelector.DataKey.	Cambio de características de SP1.

Fecha

Historial

Motivo

Julio de 2008

Se han agregado nuevos miembros: las propiedades ColumnsGenerator, EnableModelValidation, SelectedPersistedDataKey y IPersistedSelector.DataKey.

Cambio de características de SP1.

¿Le ha resultado útil? Sí No

No es correcto

No contiene suficientes detalles

Se necesitan ejemplos de código adicionales

La traducción necesita mejoras

(Caracteres restantes: 1500)

Contenido de la comunidad Agregar

Preguntas más frecuentes

GridView (Clase)

Introduction

Campos de columna

Enlace a datos

Operaciones de datos

Personalizar la interfaz de usuario

Eventos

Accesibilidad

Sintaxis de la declaración

.NET Framework

Referencia

Otros recursos