Compartir a través de


DataGridColumn.InitializeCell(TableCell, Int32, ListItemType) Método

Definición

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 -> unit
Public Overridable Sub InitializeCell (cell As TableCell, columnIndex As Integer, itemType As ListItemType)

Parámetros

cell
TableCell

Objeto TableCell que representa la celda que se va a restablecer.

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.

Se aplica a