DataGridColumn.InitializeCell(TableCell, Int32, ListItemType) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona la implementación base para restablecer a su estado inicial la celda especificada de una columna derivada de la clase DataGridColumn.
public:
virtual void InitializeCell(System::Web::UI::WebControls::TableCell ^ cell, int columnIndex, System::Web::UI::WebControls::ListItemType itemType);public virtual void InitializeCell (System.Web.UI.WebControls.TableCell cell, int columnIndex, System.Web.UI.WebControls.ListItemType itemType);abstract member InitializeCell : System.Web.UI.WebControls.TableCell * int * System.Web.UI.WebControls.ListItemType -> unit
override this.InitializeCell : System.Web.UI.WebControls.TableCell * int * System.Web.UI.WebControls.ListItemType -> unitPublic Overridable Sub InitializeCell (cell As TableCell, columnIndex As Integer, itemType As ListItemType)Parámetros
- columnIndex
- Int32
Número de columna donde está ubicada la celda.
- itemType
- ListItemType
Uno de los valores de ListItemType.
Comentarios
El InitializeCell método proporciona la implementación base para restablecer la celda especificada de una columna derivada de la DataGridColumn clase a su estado inicial. No se llama directamente a este método. En su lugar, este método lo hereda una clase de columna derivada, que luego se puede usar para restablecer una celda en la columna del tipo derivado. Opcionalmente, puede invalidar este método en la clase derivada para proporcionar una rutina de inicialización personalizada. Esta implementación base del InitializeCell método se suele llamar desde el método invalidado para restablecer las propiedades comunes a todas las celdas de las columnas derivadas de la DataGridColumn clase .
En esta implementación, el InitializeCell método restablece solo las celdas de encabezado y pie de página. Otros tipos de celdas no se ven afectados por este método.
Cuando la ordenación está habilitada (estableciendo la AllowSorting propiedad trueen ), se agrega un LinkButton control a la celda de encabezado de forma predeterminada. Esto le permite ordenar la columna cuando se hace clic en el LinkButton control. Si especifica una imagen para la celda de encabezado (estableciendo la HeaderImageUrl propiedad ), se crea un ImageButton control en su lugar.
Cuando la ordenación está deshabilitada, el texto especificado por la HeaderText propiedad se muestra en la celda de encabezado. Si especifica una imagen para la celda de encabezado (estableciendo la HeaderImageUrl propiedad ), se agrega un Image control a la celda de encabezado.
Dado que un explorador no mostrará una celda vacía, si no se muestra una imagen en la celda de encabezado y la HeaderText propiedad no está establecida, se muestra una entidad HTML de espacio no separado ( ) en la celda de encabezado. Del mismo modo, si la celda de pie de página no tiene contenido (si la FooterText propiedad no está establecida), se muestra una entidad HTML de espacio sin separación en la celda del pie de página.
Nota
Normalmente, los desarrolladores de controles usan este método.