DataGrid Clase
TOC
Collapse the table of content
Expand the table of content
Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

DataGrid (Clase)

 

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

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

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

public class DataGrid : BaseDataList, INamingContainer

NombreDescripción
System_CAPS_pubmethodDataGrid()

Inicializa una nueva instancia de la clase DataGrid.

NombreDescripción
System_CAPS_pubpropertyAccessKey

Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor Web.(Heredado de WebControl.)

System_CAPS_protpropertyAdapter

Obtiene el adaptador específico del explorador para el control.(Heredado de Control.)

System_CAPS_pubpropertyAllowCustomPaging

Obtiene o establece un valor que indica si está habilitada la paginación personalizada.

System_CAPS_pubpropertyAllowPaging

Obtiene o establece un valor que indica si está habilitada la paginación.

System_CAPS_pubpropertyAllowSorting

Obtiene o establece un valor que indica si está habilitada la ordenación.

System_CAPS_pubpropertyAlternatingItemStyle

Obtiene las propiedades de estilo para los elementos alternos de la DataGrid control.

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativa a la aplicación de la Page o UserControl objeto que contiene este control.(Heredado de Control.)

System_CAPS_pubpropertyAttributes

Obtiene la colección de atributos arbitrarios (sólo para representación) que no corresponden a propiedades del control.(Heredado de WebControl.)

System_CAPS_pubpropertyAutoGenerateColumns

Obtiene o establece un valor que indica si BoundColumn objetos se crean automáticamente y se muestra en el DataGrid control para cada campo del origen de datos.

System_CAPS_pubpropertyBackColor

Obtiene o establece el color de fondo del control de servidor Web.(Heredado de WebControl.)

System_CAPS_pubpropertyBackImageUrl

Obtiene o establece la dirección URL de una imagen para mostrar en el fondo de la DataGrid control.

System_CAPS_pubpropertyBindingContainer

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Obtiene el control que contiene el enlace de datos del control.(Heredado de Control.)

System_CAPS_pubpropertyBorderColor

Obtiene o establece el color del borde del control Web.(Heredado de WebControl.)

System_CAPS_pubpropertyBorderStyle

Obtiene o establece el estilo de borde del control de servidor Web.(Heredado de WebControl.)

System_CAPS_pubpropertyBorderWidth

Obtiene o establece el ancho del borde del control de servidor Web.(Heredado de WebControl.)

System_CAPS_pubpropertyCaption

Obtiene o establece el texto que se va a representar en un elemento de título HTML del control. Esta propiedad se proporciona para que el control sea más accesible para los usuarios de dispositivos de tecnología de asistencia.(Heredado de BaseDataList.)

System_CAPS_pubpropertyCaptionAlign

Obtiene o establece la posición horizontal o vertical del elemento de título HTML en un control. Esta propiedad se proporciona para que el control sea más accesible para los usuarios de dispositivos de tecnología de asistencia.(Heredado de BaseDataList.)

System_CAPS_pubpropertyCellPadding

Obtiene o establece la cantidad de espacio entre el contenido de una celda y su borde.(Heredado de BaseDataList.)

System_CAPS_pubpropertyCellSpacing

Obtiene o establece la cantidad de espacio entre las celdas.(Heredado de BaseDataList.)

System_CAPS_protpropertyChildControlsCreated

Obtiene un valor que indica si se crearon los controles secundarios del control de servidor.(Heredado de Control.)

System_CAPS_pubpropertyClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.(Heredado de Control.)

System_CAPS_pubpropertyClientIDMode

Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad.(Heredado de Control.)

System_CAPS_protpropertyClientIDSeparator

Obtiene un valor de carácter que representa el carácter separador utilizado en el ClientID propiedad.(Heredado de Control.)

System_CAPS_pubpropertyColumns

Obtiene una colección de objetos que representan las columnas de la DataGrid control.

System_CAPS_protpropertyContext

Obtiene el HttpContext objeto asociado con el control de servidor para la solicitud Web actual.(Heredado de Control.)

System_CAPS_pubpropertyControls

Obtiene un System.Web.UI.ControlCollection objeto que contiene una colección de controles secundarios en un control de lista de datos.(Heredado de BaseDataList.)

System_CAPS_pubpropertyControlStyle

Obtiene el estilo del control de servidor Web. Esta propiedad la usan principalmente los programadores de controles.(Heredado de WebControl.)

System_CAPS_pubpropertyControlStyleCreated

Obtiene un valor que indica si un Style se ha creado el objeto para el ControlStyle propiedad. Esta propiedad se utiliza principalmente los programadores de controles.(Heredado de WebControl.)

System_CAPS_pubpropertyCssClass

Obtiene o establece la clase de hoja de estilos en cascada (CSS) representada por el control de servidor Web en el cliente.(Heredado de WebControl.)

System_CAPS_pubpropertyCurrentPageIndex

Obtiene o establece el índice de la página mostrada actualmente.

System_CAPS_pubpropertyDataItemContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataItemContainer.(Heredado de Control.)

System_CAPS_pubpropertyDataKeyField

Obtiene o establece el campo de clave en el origen de datos especificado por la DataSource propiedad.(Heredado de BaseDataList.)

System_CAPS_pubpropertyDataKeys

Obtiene un DataKeyCollection objeto que almacena los valores clave de cada registro de un control de lista de datos.(Heredado de BaseDataList.)

System_CAPS_protpropertyDataKeysArray

Obtiene un ArrayList objeto que contiene los valores clave de cada registro de un control de lista de datos.(Heredado de BaseDataList.)

System_CAPS_pubpropertyDataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataKeysControl.(Heredado de Control.)

System_CAPS_pubpropertyDataMember

Obtiene o establece al miembro de datos específico en un origen de datos de varios miembros para enlazar a un control de lista de datos.(Heredado de BaseDataList.)

System_CAPS_pubpropertyDataSource

Obtiene o establece el origen que contiene una lista de valores que se utilizan para rellenar los elementos dentro del control.(Heredado de BaseDataList.)

System_CAPS_pubpropertyDataSourceID

Obtiene o establece la ID propiedad del control de origen de datos que deben usar el control de lista de datos para recuperar su origen de datos.(Heredado de BaseDataList.)

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.(Heredado de Control.)

System_CAPS_pubpropertyEditItemIndex

Obtiene o establece el índice de un elemento en el DataGrid control de edición.

System_CAPS_pubpropertyEditItemStyle

Obtiene las propiedades de estilo del elemento seleccionado para su edición en el DataGrid control.

System_CAPS_pubpropertyEnabled

Obtiene o establece un valor que indica si está habilitado el control de servidor Web.(Heredado de WebControl.)

System_CAPS_pubpropertyEnableTheming

Obtiene o establece un valor que indica si se aplican temas a este control.(Heredado de WebControl.)

System_CAPS_pubpropertyEnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.(Heredado de Control.)

System_CAPS_protpropertyEvents

Obtiene una lista de delegados de controladores de eventos para el control. Esta propiedad es de sólo lectura.(Heredado de Control.)

System_CAPS_pubpropertyFont

Obtiene las propiedades de fuente asociadas con el control de servidor Web.(Heredado de WebControl.)

System_CAPS_pubpropertyFooterStyle

Obtiene las propiedades de estilo de la sección de pie de página en el DataGrid control.

System_CAPS_pubpropertyForeColor

Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor Web.(Heredado de WebControl.)

System_CAPS_pubpropertyGridLines

Obtiene o establece un valor que especifica si se muestra el borde entre las celdas de un control de lista de datos.(Heredado de BaseDataList.)

System_CAPS_pubpropertyHasAttributes

Obtiene un valor que indica si el control tiene un atributo del conjunto.(Heredado de WebControl.)

System_CAPS_protpropertyHasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardado.(Heredado de Control.)

System_CAPS_pubpropertyHeaderStyle

Obtiene las propiedades de estilo de la sección de encabezado en el DataGrid control.

System_CAPS_pubpropertyHeight

Obtiene o establece el alto del control de servidor Web.(Heredado de WebControl.)

System_CAPS_pubpropertyHorizontalAlign

Obtiene o establece la alineación horizontal de un control dentro de su contenedor de lista de datos.(Heredado de BaseDataList.)

System_CAPS_pubpropertyID

Obtiene o establece el identificador de programación asignado al control de servidor.(Heredado de Control.)

System_CAPS_protpropertyIdSeparator

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Obtiene el carácter utilizado para separar los identificadores de control.(Heredado de Control.)

System_CAPS_protpropertyInitialized

Obtiene un valor que indica si se ha inicializado el control.(Heredado de BaseDataList.)

System_CAPS_protpropertyIsBoundUsingDataSourceID

Obtiene un valor que indica si el DataSourceID se establece la propiedad.(Heredado de BaseDataList.)

System_CAPS_protpropertyIsChildControlStateCleared

Obtiene un valor que indica si los controles incluidos en este control tienen estado de control.(Heredado de Control.)

System_CAPS_protpropertyIsEnabled

Obtiene un valor que indica si el control está habilitado.(Heredado de WebControl.)

System_CAPS_protpropertyIsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios en su estado de vista.(Heredado de Control.)

System_CAPS_protpropertyIsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.(Heredado de Control.)

System_CAPS_pubpropertyItems

Obtiene una colección de DataGridItem objetos que representan los elementos individuales de la DataGrid control.

System_CAPS_pubpropertyItemStyle

Obtiene las propiedades de estilo de los elementos de la DataGrid control.

System_CAPS_protpropertyLoadViewStateByID

Obtiene un valor que indica si el control participa en la carga su estado de vista por ID en lugar de índice.(Heredado de Control.)

System_CAPS_pubpropertyNamingContainer

Obtiene una referencia al control de servidor de nombres del contenedor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor con el mismo Control.ID valor de propiedad.(Heredado de Control.)

System_CAPS_pubpropertyPage

Obtiene una referencia a la Page instancia que contiene el control de servidor.(Heredado de Control.)

System_CAPS_pubpropertyPageCount

Obtiene el número total de páginas necesarias para mostrar los elementos en el DataGrid control.

System_CAPS_pubpropertyPagerStyle

Obtiene las propiedades de estilo de la sección de paginación del DataGrid control.

System_CAPS_pubpropertyPageSize

Obtiene o establece el número de elementos para mostrar en una sola página de la DataGrid control.

System_CAPS_pubpropertyParent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.(Heredado de Control.)

System_CAPS_pubpropertyRenderingCompatibility

Obtiene un valor que especifica será compatible con la versión de ASP.NET que se representa en HTML.(Heredado de Control.)

System_CAPS_protpropertyRequiresDataBinding

Obtiene o establece un valor que indica si el control de lista de datos necesitan enlazarse a su origen de datos especificado.(Heredado de BaseDataList.)

System_CAPS_protpropertySelectArguments

Obtiene un DataSourceSelectArguments que el control enlazado a datos se utiliza al recuperar datos de un control de origen de datos de objeto.(Heredado de BaseDataList.)

System_CAPS_pubpropertySelectedIndex

Obtiene o establece el índice del elemento seleccionado del control DataGrid.

System_CAPS_pubpropertySelectedItem

Obtiene un DataGridItem objeto que representa el elemento seleccionado en el DataGrid control.

System_CAPS_pubpropertySelectedItemStyle

Obtiene las propiedades de estilo del elemento actualmente seleccionado en el DataGrid control.

System_CAPS_pubpropertyShowFooter

Obtiene o establece un valor que indica si el pie de página se muestra en el DataGrid control.

System_CAPS_pubpropertyShowHeader

Obtiene o establece un valor que indica si el encabezado se muestra en el DataGrid control.

System_CAPS_pubpropertySite

Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño.(Heredado de Control.)

System_CAPS_pubpropertySkinID

Obtiene o establece la máscara que se aplica al control.(Heredado de WebControl.)

System_CAPS_pubpropertyStyle

Obtiene una colección de atributos de texto que se representan como un atributo de estilo en la etiqueta externa del control de servidor Web.(Heredado de WebControl.)

System_CAPS_pubpropertySupportsDisabledAttribute

Obtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML representado cuando el valor de la propiedad IsEnabled del control es false.(Heredado de BaseDataList.)

System_CAPS_pubpropertyTabIndex

Obtiene o establece el índice de tabulación del control de servidor Web.(Heredado de WebControl.)

System_CAPS_protpropertyTagKey

Obtiene el valor HtmlTextWriterTag del control DataGrid.(Reemplaza a WebControl.TagKey).

System_CAPS_protpropertyTagName

Obtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles.(Heredado de WebControl.)

System_CAPS_pubpropertyTemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.(Heredado de Control.)

System_CAPS_pubpropertyTemplateSourceDirectory

Obtiene el directorio virtual de la Page o UserControl que contiene el control de servidor actual.(Heredado de Control.)

System_CAPS_pubpropertyToolTip

Obtiene o establece el texto mostrado cuando el puntero del mouse se sitúa sobre el control de servidor Web.(Heredado de WebControl.)

System_CAPS_pubpropertyUniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.(Heredado de Control.)

System_CAPS_pubpropertyUseAccessibleHeader

Obtiene o establece un valor que indica si el control de lista de datos representan su encabezado en un formato accesible. Esta propiedad se proporciona para que el control sea más accesible para los usuarios de dispositivos de tecnología de asistencia.(Heredado de BaseDataList.)

System_CAPS_pubpropertyValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el Explorador de valores potencialmente peligrosos.(Heredado de Control.)

System_CAPS_protpropertyViewState

Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor a través de varias solicitudes de la misma página.(Heredado de Control.)

System_CAPS_protpropertyViewStateIgnoresCase

Obtiene un valor que indica si la StateBag objeto distingue mayúsculas de minúsculas.(Heredado de Control.)

System_CAPS_pubpropertyViewStateMode

Obtiene o establece el modo de estado de vista de este control.(Heredado de Control.)

System_CAPS_pubpropertyVirtualItemCount

Obtiene o establece el número virtual de elementos de la DataGrid controlar cuando se utiliza la paginación personalizada.

System_CAPS_pubpropertyVisible

Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página.(Heredado de Control.)

System_CAPS_pubpropertyWidth

Obtiene o establece el ancho del control de servidor web.(Heredado de WebControl.)

NombreDescripción
System_CAPS_protmethodAddAttributesToRender(HtmlTextWriter)

Agrega atributos y estilos que se deben representar HTML especificado HtmlTextWriterTag. Este método se usa principalmente los programadores de controles.(Heredado de WebControl.)

System_CAPS_protmethodAddedControl(Control, Int32)

Se llama después de que se agrega un control secundario a la Controls colección de la Control objeto.(Heredado de Control.)

System_CAPS_protmethodAddParsedSubObject(Object)

Notifica al control de servidor que se analizó un elemento, XML o HTML y agrega el elemento en el control de servidor ControlCollection colección.(Heredado de BaseDataList.)

System_CAPS_pubmethodApplyStyle(Style)

Copia los elementos no vacíos del estilo especificado en el control Web, sobrescribiendo los elementos de estilo existentes del control. Este método se utiliza principalmente los programadores de controles.(Heredado de WebControl.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Se aplica a las propiedades de estilo definidas en la hoja de estilo de página para el control.(Heredado de Control.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Comienza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Recopila información sobre el control de servidor y la pasa a la Trace propiedad que se mostrará cuando el seguimiento está habilitado para la página.(Heredado de Control.)

System_CAPS_protmethodClearCachedClientID()

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Establece la caché ClientID valor a null.(Heredado de Control.)

System_CAPS_protmethodClearChildControlState()

Elimina la información de estado de control para los controles secundarios del control de servidor.(Heredado de Control.)

System_CAPS_protmethodClearChildState()

Elimina la información de estado de vista y el estado de control para los controles secundarios todos del control de servidor.(Heredado de Control.)

System_CAPS_protmethodClearChildViewState()

Elimina la información de estado de vista para todo el servidor controles secundarios del control.(Heredado de Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Establece el ClientIDMode propiedad de la instancia actual del control y de todos los controles secundarios a Inherit.(Heredado de Control.)

System_CAPS_pubmethodCopyBaseAttributes(WebControl)

Copia las propiedades que no están encapsuladas por la Style objeto desde el control de servidor Web especificado al control de servidor Web que se llama a este método. Este método se usa principalmente los programadores de controles.(Heredado de WebControl.)

System_CAPS_protmethodCreateChildControls()

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Crea un control secundario mediante el estado de vista.(Heredado de BaseDataList.)

System_CAPS_protmethodCreateColumnSet(PagedDataSource, Boolean)

Crea el conjunto de columnas que se usarán para generar la jerarquía de controles. Cuando AutoGenerateColumns es true, las columnas se crean para que coincida con el origen de datos y se anexan al conjunto de columnas definidas en el Columns colección.

System_CAPS_protmethodCreateControlCollection()

Crea un nuevo ControlCollection objeto para contener los controles secundarios (literal y servidor) del control de servidor.(Heredado de Control.)

System_CAPS_protmethodCreateControlHierarchy(Boolean)

Crea la jerarquía de controles que se usa para representar el DataGrid.(Reemplaza a BaseDataList.CreateControlHierarchy(Boolean)).

System_CAPS_protmethodCreateControlStyle()

Crea el nuevo estilo del control.(Reemplaza a WebControl.CreateControlStyle()).

System_CAPS_protmethodCreateDataSourceSelectArguments()

Crea un valor predeterminado DataSourceSelectArguments objeto utilizado por el control enlazado a datos si no se especifica ningún argumento.(Heredado de BaseDataList.)

System_CAPS_protmethodCreateItem(Int32, Int32, ListItemType)

Crea un objeto DataGridItem.

System_CAPS_pubmethodDataBind()

Enlaza el control y todos sus controles secundarios al origen de datos especificado.(Heredado de BaseDataList.)

System_CAPS_protmethodDataBind(Boolean)

Enlaza un origen de datos para el control de servidor invocado y todos sus controles secundarios con una opción para generar el DataBinding eventos.(Heredado de Control.)

System_CAPS_protmethodDataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.(Heredado de Control.)

System_CAPS_pubmethodDispose()

Habilita un control de servidor realizar la limpieza final antes de que se libere de la memoria.(Heredado de Control.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Finaliza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control.)

System_CAPS_protmethodEnsureChildControls()

Determina si el control de servidor contiene controles secundarios. Si no es así, crea controles secundarios.(Heredado de Control.)

System_CAPS_protmethodEnsureDataBound()

Comprueba que el control de lista de datos requieren enlace de datos y que se ha especificado un control de origen de datos válido antes de llamar a la DataBind (método).(Heredado de BaseDataList.)

System_CAPS_protmethodEnsureID()

Crea un identificador para los controles que no tienen un identificador asignado.(Heredado de Control.)

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object.)

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object.)

System_CAPS_pubmethodFindControl(String)

Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id parámetro.(Heredado de Control.)

System_CAPS_protmethodFindControl(String, Int32)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id y un entero especificado en el pathOffset parámetro, lo que ayuda en la búsqueda. No se debe reemplazar esta versión de la FindControl (método).(Heredado de Control.)

System_CAPS_pubmethodFocus()

Establece el foco en un control de entrada.(Heredado de Control.)

System_CAPS_protmethodGetData()

Devuelve un IEnumerable-implementa el objeto que representa el origen de datos.(Heredado de BaseDataList.)

System_CAPS_protmethodGetDesignModeState()

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Obtiene los datos de tiempo de diseño para un control.(Heredado de Control.)

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object.)

System_CAPS_pubmethodGetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.(Heredado de Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.(Heredado de Control.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.(Heredado de Control.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.(Heredado de Control.)

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Devuelve la parte fija de la UniqueID propiedad del control especificado.(Heredado de Control.)

System_CAPS_pubmethodHasControls()

Determina si el control de servidor contiene todos los controles secundarios.(Heredado de Control.)

System_CAPS_protmethodHasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.(Heredado de Control.)

System_CAPS_protmethodInitializeItem(DataGridItem, DataGridColumn[])

Inicializa especificado DataGridItem objeto.

System_CAPS_protmethodInitializePager(DataGridItem, Int32, PagedDataSource)

Crea un DataGridItem objeto que contiene la interfaz de usuario de paginación.

System_CAPS_protmethodIsLiteralContent()

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Determina si el control de servidor alberga únicamente contenido literal.(Heredado de Control.)

System_CAPS_protmethodLoadControlState(Object)

Restaura la información de estado de control de una solicitud de página anterior guardada por el SaveControlState (método).(Heredado de Control.)

System_CAPS_protmethodLoadViewState(Object)

Carga el estado guardado de la DataGrid.(Reemplaza a WebControl.LoadViewState(Object)).

System_CAPS_protmethodMapPathSecure(String)

Recupera la ruta de acceso física que se asigna una ruta de acceso virtual absoluta o relativa, a.(Heredado de Control.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object.)

System_CAPS_pubmethodMergeStyle(Style)

Copia los elementos no vacíos del estilo especificado en el Web controlan pero no sobrescribirá ningún elemento de estilo existente del control. Este método se usa principalmente los programadores de controles.(Heredado de WebControl.)

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Pasa el evento provocado por un control del contenedor hasta la jerarquía de controles de servidor de interfaz de usuario de la página.(Reemplaza a Control.OnBubbleEvent(Object, EventArgs)).

System_CAPS_protmethodOnCancelCommand(DataGridCommandEventArgs)

Genera el evento CancelCommand. Esto permite incluir un control personalizado para el evento.

System_CAPS_protmethodOnDataBinding(EventArgs)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Genera el DataBinding eventos de un BaseDataList control.(Heredado de BaseDataList.)

System_CAPS_protmethodOnDataPropertyChanged()

Se llama cuando se cambia una de las propiedades de identificación del origen de datos base, para volver a enlazar el control enlazado a datos a sus datos.(Heredado de BaseDataList.)

System_CAPS_protmethodOnDataSourceViewChanged(Object, EventArgs)

Genera el evento DataSourceViewChanged.(Heredado de BaseDataList.)

System_CAPS_protmethodOnDeleteCommand(DataGridCommandEventArgs)

Genera el evento DeleteCommand. Esto permite incluir un control personalizado para el evento.

System_CAPS_protmethodOnEditCommand(DataGridCommandEventArgs)

Genera el evento EditCommand. Esto permite incluir un control personalizado para el evento.

System_CAPS_protmethodOnInit(EventArgs)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Genera el evento Init para el control BaseDataList.(Heredado de BaseDataList.)

System_CAPS_protmethodOnItemCommand(DataGridCommandEventArgs)

Genera el evento ItemCommand. Esto permite incluir un control personalizado para el evento.

System_CAPS_protmethodOnItemCreated(DataGridItemEventArgs)

Genera el evento ItemCreated. Esto permite incluir un control personalizado para el evento.

System_CAPS_protmethodOnItemDataBound(DataGridItemEventArgs)

Genera el evento ItemDataBound. Esto permite incluir un control personalizado para el evento.

System_CAPS_protmethodOnLoad(EventArgs)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Genera el evento Load.(Heredado de BaseDataList.)

System_CAPS_protmethodOnPageIndexChanged(DataGridPageChangedEventArgs)

Genera el evento PageIndexChanged. Esto permite incluir un control personalizado para el evento.

System_CAPS_protmethodOnPreRender(EventArgs)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Genera el evento PreRender.(Heredado de BaseDataList.)

System_CAPS_protmethodOnSelectedIndexChanged(EventArgs)

Genera el SelectedIndexChanged eventos de un BaseDataList control.(Heredado de BaseDataList.)

System_CAPS_protmethodOnSortCommand(DataGridSortCommandEventArgs)

Genera el evento SortCommand. Esto permite incluir un control personalizado para el evento.

System_CAPS_protmethodOnUnload(EventArgs)

Genera el evento Unload.(Heredado de Control.)

System_CAPS_protmethodOnUpdateCommand(DataGridCommandEventArgs)

Genera el evento UpdateCommand. Esto permite incluir un control personalizado para el evento.

System_CAPS_protmethodOpenFile(String)

Obtiene un Stream utilizado para leer un archivo.(Heredado de Control.)

System_CAPS_protmethodPrepareControlHierarchy()

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Establece la jerarquía de control para este DataGrid control.(Reemplaza a BaseDataList.PrepareControlHierarchy()).

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al elemento primario del control.(Heredado de Control.)

System_CAPS_protmethodRemovedControl(Control)

Se llama después de que se quita un control secundario de la Controls colección de la Control objeto.(Heredado de Control.)

System_CAPS_protmethodRender(HtmlTextWriter)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Representa el control en el sistema de escritura HTML especificado.(Heredado de BaseDataList.)

System_CAPS_pubmethodRenderBeginTag(HtmlTextWriter)

Representa la etiqueta HTML de apertura del control en el escritor especificado. Este método se usa principalmente los programadores de controles.(Heredado de WebControl.)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Envía el contenido de los elementos secundarios de un control de servidor a un HtmlTextWriter objeto, que escribe el contenido que se va a representar en el cliente.(Heredado de Control.)

System_CAPS_protmethodRenderContents(HtmlTextWriter)

Representa el contenido del control en el escritor especificado. Este método se usa principalmente los programadores de controles.(Heredado de WebControl.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Genera el contenido del control de servidor a un HtmlTextWriter de objeto y almacena información de seguimiento sobre el control si está habilitado el seguimiento.(Heredado de Control.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Genera el contenido del control de servidor a un HtmlTextWriter objeto usando una URL ControlAdapter objeto.(Heredado de Control.)

System_CAPS_pubmethodRenderEndTag(HtmlTextWriter)

Representa la etiqueta HTML de cierre del control en el escritor especificado. Este método se usa principalmente los programadores de controles.(Heredado de WebControl.)

System_CAPS_protmethodResolveAdapter()

Obtiene el adaptador de control responsable de representar el control especificado.(Heredado de Control.)

System_CAPS_pubmethodResolveClientUrl(String)

Obtiene una dirección URL que se puede usar el explorador.(Heredado de Control.)

System_CAPS_pubmethodResolveUrl(String)

Convierte una dirección URL en una que se puede usar en el cliente solicitante.(Heredado de Control.)

System_CAPS_protmethodSaveControlState()

Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor.(Heredado de Control.)

System_CAPS_protmethodSaveViewState()

Guarda el estado actual de la DataGrid.(Reemplaza a WebControl.SaveViewState()).

System_CAPS_protmethodSetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.(Heredado de Control.)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.(Heredado de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando la clave de datos de seguimiento y el valor de datos de seguimiento de seguimiento.(Heredado de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando el objeto de seguimiento, la clave de datos de seguimiento y el valor de datos de seguimiento de traza.(Heredado de Control.)

System_CAPS_pubmethodToString()

Retorna una cadena que representa al objeto actual. (Heredado de Object.)

System_CAPS_protmethodTrackViewState()

Marca el punto de partida para comenzar el seguimiento y guardar cambios en el control como parte del estado de vista del control.(Reemplaza a WebControl.TrackViewState()).

NombreDescripción
System_CAPS_pubfieldSystem_CAPS_staticCancelCommandName

Representa el Cancel nombre del comando. Este campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticDeleteCommandName

Representa el nombre de comando Delete. Este campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticEditCommandName

Representa el nombre de comando de edición. Este campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticNextPageCommandArgument

Representa el argumento de comando Next. Este campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticPageCommandName

Representa el nombre de comando de página. Este campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticPrevPageCommandArgument

Representa el argumento de comando Prev. Este campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticSelectCommandName

Representa el nombre de comando Select. Este campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticSortCommandName

Representa el nombre de comando Sort. Este campo es de solo lectura.

System_CAPS_pubfieldSystem_CAPS_staticUpdateCommandName

Representa el nombre de comando de actualización. Este campo es de solo lectura.

NombreDescripción
System_CAPS_pubeventCancelCommand

Se produce cuando el Cancel se hace clic en un elemento en el DataGrid control.

System_CAPS_pubeventDataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.(Heredado de Control.)

System_CAPS_pubeventDeleteCommand

Se produce cuando se hace clic en el botón Eliminar para un elemento en el DataGrid control.

System_CAPS_pubeventDisposed

Se produce cuando un control de servidor se libera de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página ASP.NET.(Heredado de Control.)

System_CAPS_pubeventEditCommand

Se produce cuando se hace clic en el botón Editar para un elemento en el DataGrid control.

System_CAPS_pubeventInit

Se produce cuando se inicializa el control de servidor, que es el primer paso del ciclo de vida.(Heredado de Control.)

System_CAPS_pubeventItemCommand

Se produce cuando se hace clic en cualquier botón en el DataGrid control.

System_CAPS_pubeventItemCreated

Se produce en el servidor cuando un elemento en el DataGrid se crea el control.

System_CAPS_pubeventItemDataBound

Se produce después de que un elemento está enlazado a datos el DataGrid control.

System_CAPS_pubeventLoad

Se produce cuando el control de servidor se carga en el Page objeto.(Heredado de Control.)

System_CAPS_pubeventPageIndexChanged

Se produce cuando se hace clic en uno de los elementos de selección de página.

System_CAPS_pubeventPreRender

Se produce después de la Control es cargado pero antes de la representación.(Heredado de Control.)

System_CAPS_pubeventSelectedIndexChanged

Se produce cuando se selecciona un elemento diferente en un control entre cada envío al servidor.(Heredado de BaseDataList.)

System_CAPS_pubeventSortCommand

Se produce cuando se ordena una columna.

System_CAPS_pubeventUnload

Se produce cuando el control de servidor se descarga de la memoria.(Heredado de Control.)

System_CAPS_pubeventUpdateCommand

Se produce cuando se hace clic en el botón de actualización para un elemento en el DataGrid control.

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.GetAttribute(String)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Obtiene un atributo del control Web con el nombre especificado.(Heredado de WebControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.SetAttribute(String, String)

Establece un atributo del control Web en el nombre y valor especificados.(Heredado de WebControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Para una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState.(Heredado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Para una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState.(Heredado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Para una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl.(Heredado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Para una descripción de este miembro, vea IParserAccessor.AddParsedSubObject.(Heredado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Para una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder.(Heredado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Para una descripción de este miembro, vea IControlDesignerAccessor.UserData.(Heredado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.DataBindings.(Heredado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings.(Heredado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Para una descripción de este miembro, vea IExpressionsAccessor.Expressions.(Heredado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Para una descripción de este miembro, vea IExpressionsAccessor.HasExpressions.(Heredado de Control.)

NombreDescripción
System_CAPS_pubmethodEnableDynamicData(Type)

Sobrecargado. Habilita el comportamiento de datos dinámicos para el control de datos especificado.(Defined by DataControlExtensions.)

System_CAPS_pubmethodEnableDynamicData(Type, IDictionary<String, Object>)

Sobrecargado. Habilita el comportamiento de datos dinámicos para el control de datos especificado.(Defined by DataControlExtensions.)

System_CAPS_pubmethodEnableDynamicData(Type, Object)

Sobrecargado. Habilita el comportamiento de datos dinámicos para el control de datos especificado.(Defined by DataControlExtensions.)

System_CAPS_pubmethodFindDataSourceControl()

Devuelve el origen de datos que está asociado con el control de datos para el control especificado.(Defined by DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Devuelve que el contenedor de nomenclatura de la plantilla de campo para la columna especificada en el control especificado.(Defined by DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Devuelve el objeto de metatabla para el control de datos que contiene.(Defined by DynamicDataExtensions.)

System_CAPS_pubmethodGetDefaultValues()

Sobrecargado. Obtiene la colección de los valores predeterminados para el control de datos especificado.(Defined by DynamicDataExtensions.)

System_CAPS_pubmethodGetMetaTable()

Sobrecargado. Obtiene los metadatos de la tabla para el control de datos especificado.(Defined by DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable)

Sobrecargado. Establece los metadatos de la tabla para el control de datos especificado.(Defined by DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable, IDictionary<String, Object>)

Sobrecargado. Establece la asignación de valores de metadatos y el valor predeterminado de tabla para el control de datos especificado.(Defined by DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable, Object)

Sobrecargado. Establece la asignación de valores de metadatos y el valor predeterminado de tabla para el control de datos especificado.(Defined by DynamicDataExtensions.)

System_CAPS_pubmethodTryGetMetaTable(MetaTable)

Sobrecargado. Determina si los metadatos de la tabla están disponible.(Defined by DynamicDataExtensions.)

En este tema:

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

System_CAPS_cautionPrecaución

Este control se puede utilizar para mostrar los datos proporcionados por el usuario, que pueden incluir script de cliente malintencionado. Compruebe que cualquier información que se envía desde un cliente de secuencias de comandos ejecutables, instrucciones SQL u otro código antes de mostrarla en la aplicación. ASP.NET proporciona una característica de validación de solicitudes de entrada para bloquear secuencias de comandos y código HTML en la entrada del usuario. También se proporcionan controles de servidor de validación para evaluar la entrada del usuario. Para obtener más información, consulte sintaxis de Control de servidor de validación.

Diferentes tipos de columna determinan el comportamiento de las columnas en el control. En la tabla siguiente se enumera los diferentes tipos de columna que se pueden utilizar.

Tipo de columna

Descripción

BoundColumn

Muestra una columna enlazada a un campo de un origen de datos. Cada elemento muestra en el campo como texto. Este es el tipo de columna predeterminado de la DataGrid control.

ButtonColumn

Muestra un botón de comando para cada elemento de la columna. Esto le permite crear una columna de controles de botón personalizados, como Add o Remove botones.

EditCommandColumn

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

HyperLinkColumn

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

TemplateColumn

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

De forma predeterminada, la AutoGenerateColumns propiedad se establece en true, que crea un BoundColumn objeto para cada campo del origen de datos. A continuación, se procesa cada campo como una columna en el DataGrid control en el orden de aparición de cada campo del origen de datos.

Puede controlar manualmente qué columnas aparecen en el DataGrid control estableciendo la AutoGenerateColumns propiedad false y, a continuación, mostrar las columnas que desea incluir entre la apertura y cierre <Columns> etiquetas. Las columnas especificadas se agregan a la Columns enumeran la colección en el orden. Esto permite controlar mediante programación las columnas en el DataGrid control.

System_CAPS_noteNota

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

Columnas declaradas explícitamente se pueden mostrar junto con columnas generadas automáticamente. Cuando se usan ambos, las columnas declaradas explícitamente se procesan primero, seguido de las columnas generadas automáticamente.

System_CAPS_noteNota

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

La apariencia de la DataGrid puede personalizarse control estableciendo las propiedades de estilo para las diferentes partes del control. En la tabla siguiente se enumera las diferentes propiedades de estilo.

Propiedad de estilo

Descripción

AlternatingItemStyle

Especifica el estilo de los elementos alternos de la DataGrid control.

EditItemStyle

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

FooterStyle

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

HeaderStyle

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

ItemStyle

Especifica el estilo de los elementos en el DataGrid control.

PagerStyle

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

SelectedItemStyle

Especifica el estilo del elemento seleccionado en el DataGrid control.

También puede mostrar u ocultar diferentes partes del control. En la tabla siguiente se enumera las propiedades que controlan qué partes se muestran u ocultas.

Propiedad

Descripción

ShowFooter

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

ShowHeader

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

Puede controlar la apariencia de la DataGrid control agregando mediante programación atributos a las <td> y <tr> representadas por el control en el Explorador de etiquetas. Atributos se pueden agregar mediante programación proporcionando código en el controlador de eventos para el OnItemCreated o OnItemDataBound eventos.

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

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

Para obtener información acerca de cómo configurar este control para que genere un marcado que cumple los estándares de accesibilidad, consulte Accessibility in Visual Studio and ASP.NET y ASP.NET Controls and Accessibility.

<asp:DataGrid
    AccessKey="string"
    AllowCustomPaging="True|False"
    AllowPaging="True|False"
    AllowSorting="True|False"
    AutoGenerateColumns="True|False"
    BackColor="color name|#dddddd"
    BackImageUrl="uri"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    Caption="string"
    CaptionAlign="NotSet|Top|Bottom|Left|Right"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DataKeyField="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    EditItemIndex="integer"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    GridLines="None|Horizontal|Vertical|Both"
    Height="size"
    HorizontalAlign="NotSet|Left|Center|Right|Justify"
    ID="string"
    OnCancelCommand="CancelCommand event handler"
    OnDataBinding="DataBinding event handler"
    OnDeleteCommand="DeleteCommand event handler"
    OnDisposed="Disposed event handler"
    OnEditCommand="EditCommand event handler"
    OnInit="Init event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnLoad="Load event handler"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnSortCommand="SortCommand event handler"
    OnUnload="Unload event handler"
    OnUpdateCommand="UpdateCommand event handler"
    PageSize="integer"
    runat="server"
    SelectedIndex="integer"
    ShowFooter="True|False"
    ShowHeader="True|False"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    UseAccessibleHeader="True|False"
    Visible="True|False"
    Width="size"
>
        <AlternatingItemStyle />
        <Columns>
                <asp:BoundColumn
                    DataField="string"
                    DataFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    ReadOnly="True|False"
                    SortExpression="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:BoundColumn>
                <asp:ButtonColumn
                    ButtonType="LinkButton|PushButton"
                    CausesValidation="True|False"
                    CommandName="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    Text="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:ButtonColumn>
                <asp:EditCommandColumn
                    ButtonType="LinkButton|PushButton"
                    CancelText="string"
                    CausesValidation="True|False"
                    EditText="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    UpdateText="string"
                    ValidationGroup="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:EditCommandColumn>
                <asp:HyperLinkColumn
                    DataNavigateUrlField="string"
                    DataNavigateUrlFormatString="string"
                    DataTextField="string"
                    DataTextFormatString="string"
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    NavigateUrl="uri"
                    SortExpression="string"
                    Target="string|_blank|_parent|_search|_self|_top"
                    Text="string"
                    Visible="True|False"
>
                        <FooterStyle />
                        <HeaderStyle />
                        <ItemStyle />
                </asp:HyperLinkColumn>
                <asp:TemplateColumn
                    FooterText="string"
                    HeaderImageUrl="uri"
                    HeaderText="string"
                    SortExpression="string"
                    Visible="True|False"
>
                            <FooterStyle />
                            <HeaderStyle />
                            <ItemStyle />
                        <EditItemTemplate>
                            <!-- child controls -->
                        </EditItemTemplate>
                        <FooterTemplate>
                            <!-- child controls -->
                        </FooterTemplate>
                        <HeaderTemplate>
                            <!-- child controls -->
                        </HeaderTemplate>
                        <ItemTemplate>
                            <!-- child controls -->
                        </ItemTemplate>
                </asp:TemplateColumn>
        </Columns>
        <EditItemStyle />
        <FooterStyle />
        <HeaderStyle />
        <ItemStyle />
        <PagerStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            CssClass="string"
            Font-Bold="True|False"
            Font-Italic="True|False"
            Font-Names="string"
            Font-Overline="True|False"
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
                Medium|Large|X-Large|XX-Large"
            Font-Strikeout="True|False"
            Font-Underline="True|False"
            ForeColor="color name|#dddddd"
            Height="size"
            HorizontalAlign="NotSet|Left|Center|Right|Justify"
            Mode="NextPrev|NumericPages"
            NextPageText="string"
            OnDisposed="Disposed event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PrevPageText="string"
            VerticalAlign="NotSet|Top|Middle|Bottom"
            Visible="True|False"
            Width="size"
            Wrap="True|False"
        />
        <SelectedItemStyle />
</asp:DataGrid>

Un proyecto de sitio Web de Visual Studio con código fuente está disponible para este tema: Download.

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

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script language="C#" runat="server">

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

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

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

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

            dt.Rows.Add(dr);
         }

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

      void Page_Load(Object sender, EventArgs e) 
      {

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

   </script>

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

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

      <h3>DataGrid Example</h3>

      <b>Product List</b>

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

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

      </asp:DataGrid>

   </form>

</body>
</html>

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

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script language="C#" runat="server">

      DataTable Cart;
      DataView CartView;

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

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

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

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

            dt.Rows.Add(dr);
         }

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

      void Page_Load(Object sender, EventArgs e) 
      {

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

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

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

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

      void Grid_CartCommand(Object sender, DataGridCommandEventArgs e) 
      {

         DataRow dr = Cart.NewRow();

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

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

         else 
         {  

            // Remove from Cart.

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

         ShoppingCart.DataBind();

      }


   </script>

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

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

   <h3>DataGrid Example</h3>

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

            <b>Product List</b>

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

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

               <Columns>

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

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

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

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

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

                  </asp:BoundColumn>   

               </Columns>

            </asp:DataGrid>

         </td>
         <td>

            <b>Shopping Cart</b>

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

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

            </asp:DataGrid> 

         </td>
      </tr>

   </table>

   </form>

</body>
</html>

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


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script runat="server">

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

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

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

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

         dt.Rows.Add(dr);
      }

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

   void Page_Load(Object sender, EventArgs e) 
   {

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

   }

   void Item_Bound(Object sender, DataGridItemEventArgs e) 
   {

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

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

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

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

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

      }

   }

</script>

<script type="text/vbscript">

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

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

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

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

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

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

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

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

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

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

</script>

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

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

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

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

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

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

         <Columns>

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

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

            </asp:BoundColumn>

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

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

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

            </asp:BoundColumn>

         </Columns>

      </asp:DataGrid>

      <br /><br />

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

      <br /><br />

      Double click on a row to select a row.   

   </form>

</body>
</html>


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server">

      ICollection CreateDataSource() 
      {

         // Create sample data for the DataGrid control.
         DataTable dt = new DataTable();
         DataRow dr;

         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));

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

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

            dt.Rows.Add(dr);
         }

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

      void Page_Load(Object sender, EventArgs e) 
      {

         // Load sample data only once when the page is first loaded.
         if (!IsPostBack) 
         {
            ItemsGrid.DataSource = CreateDataSource();
            ItemsGrid.DataBind();
         }

      }

      void Button_Click(Object sender, EventArgs e) 
      {

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

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

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

            DetermineSelection(item, ref count);        

         }

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

            Message.Text = "No items selected";

         }

      }

      void DetermineSelection(DataGridItem item, ref int count)
      {

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

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

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

         }    

      }

   </script>

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

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

      <h3>DataGrid Example</h3>

      <b>Product List</b>

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

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

         <Columns>

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

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

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

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

            </asp:BoundColumn>

            <asp:TemplateColumn HeaderText="Select Item">

               <ItemTemplate>

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

               </ItemTemplate>

            </asp:TemplateColumn>

         </Columns> 

      </asp:DataGrid>

      <br /><br />

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

      <br /><br />

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

   </form>

</body>
</html>

.NET Framework
Disponible desde 1.1

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.

Volver al principio
Mostrar:
© 2016 Microsoft