Esta documentación está archivada y no tiene mantenimiento.

GridView (Clase)

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 editar estos elementos.

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

[ControlValuePropertyAttribute("SelectedValue")] 
public class GridView : CompositeDataBoundControl, IPostBackContainer, IPostBackEventHandler, ICallbackContainer, 
	ICallbackEventHandler
/** @attribute ControlValuePropertyAttribute("SelectedValue") */ 
public class GridView extends CompositeDataBoundControl implements IPostBackContainer, IPostBackEventHandler, 
	ICallbackContainer, ICallbackEventHandler
ControlValuePropertyAttribute("SelectedValue") 
public class GridView extends CompositeDataBoundControl implements IPostBackContainer, IPostBackEventHandler, 
	ICallbackContainer, ICallbackEventHandler
No aplicable.

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.

NotaNota:

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 de verificación 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 en 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.

NotaNota:

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 SqlDataSource, ObjectDataSource, etc.), así como a cualquier origen de datos que implemente la interfaz System.Collections.IEnumerable (como System.Data.DataView, System.Collections.ArrayList o System.Collections.Hashtable). 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 funciones integradas 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 a datos, vea Obtener acceso a datos con ASP.NET.

NotaNota:

Este control se puede utilizar para mostrar los datos especificados por el usuario, que pueden incluir secuencias de comandos de cliente malintencionadas. Compruebe que cualquier información que se envíe desde un cliente no contiene secuencias de comandos ejecutables, 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 función de validación de las solicitudes de entrada de datos para bloquear secuencias de comandos y código HTML en los datos proporcionados por el usuario. También se proporcionan controles de servidor de validación para evaluar los datos especificados por el usuario. Para obtener más información, vea Introducción a los controles de validación.

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 funciones de ordenación automática, actualización y eliminación.

NotaNota:

El control GridView puede ofrecer compatibilidad de ordenación, actualización y eliminación con otros tipos de orígenes de datos, aunque necesitará proporcionar el controlador de eventos correspondiente con la implementación de 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.

NotaNota:

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.

NotaNota:

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 las actualizaciones y las eliminaciones, se aplican 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.

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 produzca 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 se desplaza 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 produce cuando se hace clic en un botón del control GridView. Este evento se utiliza a menudo para realizar una tarea cuando se hace clic en un botón del control.

RowCreated

Se produce 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 suele utilizarse 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 normalmente se utiliza 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

Es posible que el marcado que se representa de manera predeterminada para este control no respete los estándares de accesibilidad enunciados en las directrices prioritarias de WCAG (Instrucciones de accesibilidad a contenido Web 1.0). Para obtener detalles sobre accesibilidad compatible con este control, vea Controles y accesibilidad en ASP.NET.

TemaUbicación
Cómo: Crear plantillas de controles de servidor Web ASP.NETGenerar aplicaciones Web ASP .NET
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar un documento XML en una página de formularios Web Forms mediante transformacionesGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos en páginas Web con un componente de datos de Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles de servidor Web mediante el DiseñadorGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear una página Web para mostrar datos XMLGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear una página Web para mostrar datos de una base de datos de AccessGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar la edición predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Personalizar controles para la edición en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos de Access mediante el control AccessDataSource (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantilla en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear páginas Web principal-detalle en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar la paginación predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar la eliminación predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Ordenación simple del control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Editar e insertar datos en páginas Web con el control de servidor Web DetailsViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Acceso a datos básico en páginas WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar la selección predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar una lista desplegable mientras se edita en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos mediante un procedimiento almacenado en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Realizar actualizaciones masivas en filas enlazadas a un control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear un control GridView anidadoGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear y usar páginas principales ASP.NET en Visual Web DeveloperGenerar aplicaciones con Visual Web Developer
Tutorial: Acceso a datos básico en páginas WebGenerar aplicaciones con Visual Web Developer
Tutorial: Mostrar una lista desplegable mientras se edita en el control de servidor Web GridViewGenerar aplicaciones con Visual Web Developer
Tutorial: Crear páginas Web principal-detalle en Visual StudioGenerar aplicaciones con Visual Web Developer
Cómo: Habilitar la eliminación predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Ordenación simple del control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos en páginas Web con un componente de datos de Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Editar e insertar datos en páginas Web con el control de servidor Web DetailsViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Personalizar controles para la edición en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles Web ASP.NET mediante declaraciónGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos de Access mediante el control AccessDataSourceGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a eventos de botón en un control GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar la selección predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles de servidor Web mediante el DiseñadorGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles de servidor Web ASP.NET dinámicamenteGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Establecer dinámicamente el ancho de las columnas en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear una página Web para mostrar datos XMLGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantillaGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear una página web para mostrar datos de una base de datos de AccessGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar una lista desplegable mientras se edita en el control de servidor web GridViewdv_vwdcon
Tutorial: Realizar actualizaciones masivas en filas enlazadas a un control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos mediante un procedimiento almacenado en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar la edición predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar la paginación predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantilla en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear un control GridView anidadoGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de botón en elementos DataList o RepeaterGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar un documento XML en una página de formularios Web Forms mediante transformacionesGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles Web ASP.NET mediante declaraciónGenerar aplicaciones Web ASP .NET
Cómo: Establecer dinámicamente el ancho de las columnas en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET
Cómo: Crear plantillas de controles de servidor Web ASP.NET dinámicamenteGenerar aplicaciones Web ASP .NET
Cómo: Enlazar a los datos de un control con plantillaGenerar aplicaciones Web ASP .NET
Cómo: Responder a los eventos de botón en elementos DataList, Repeater o GridViewGenerar aplicaciones Web ASP .NET
Cómo: Habilitar la eliminación predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Ordenación simple del control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos en páginas Web con un componente de datos de Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Editar e insertar datos en páginas Web con el control de servidor Web DetailsViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Personalizar controles para la edición en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles Web ASP.NET mediante declaraciónGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Conectar con una base de datos de Access mediante el control AccessDataSourceGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar la selección predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles de servidor Web mediante el DiseñadorGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Crear plantillas de controles de servidor Web ASP.NET dinámicamenteGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Establecer dinámicamente el ancho de las columnas en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear una página Web para mostrar datos XMLGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantillaGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Enlace de datos a un objeto comercial personalizadoGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear una página web para mostrar datos de una base de datos de AccessGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Realizar actualizaciones masivas en filas enlazadas a un control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos mediante un procedimiento almacenado en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar la edición predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Habilitar la paginación predeterminada en el control de servidor Web GridViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Enlazar a los datos de un control con plantilla en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Crear un control GridView anidadoGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a los eventos de botón en elementos DataList o RepeaterGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar un documento XML en una página de formularios Web Forms mediante transformacionesGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Responder a eventos de botón en un control GridViewGenerar aplicaciones Web ASP .NET en Visual Studio

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


<%@ Page language="C#" %>

<!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" >
  <head runat="server">
    <title>GridView Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>


En el ejemplo de código siguiente se muestra cómo utilizar el control GridView para editar registros.


<%@ Page language="C#" %>

<!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" >
  <head runat="server">
    <title>GridView Edit Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Edit Example</h3>

      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames property as read-only.    -->
      <!-- No input controls are rendered for these columns in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="true"
        autogeneratedeletebutton="true"
        autogenerateeditbutton="true"
        datakeynames="CustomerID"  
        runat="server">
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers SET CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country WHERE (CustomerID = @CustomerID)"
        deletecommand="Delete from Customers where CustomerID = @CustomerID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


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

  • AspNetHostingPermission  Para trabajar en un entorno alojado en host. Valor de petición: LinkDemand; Valor de permiso: Minimal.
  • AspNetHostingPermission  Para trabajar en un entorno alojado en host. Valor de petición: InheritanceDemand; Valor de permiso: Minimal.

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

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

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

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: