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

Definição

Fornece a implementação base para reiniciar a célula especificada de uma coluna derivada da DataGridColumn classe para o seu estado inicial.

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

A TableCell que representa a célula a reiniciar.

columnIndex
Int32

O número da coluna onde a célula está localizada.

itemType
ListItemType

Um dos ListItemType valores.

Observações

O InitializeCell método fornece a implementação base para reiniciar a célula especificada de uma coluna derivada da DataGridColumn classe para o seu estado inicial. Este método não é chamado diretamente. Em vez disso, este método é herdado por uma classe de coluna derivada, que pode então ser usada para reiniciar uma célula na coluna do tipo derivado. Pode, opcionalmente, sobrescrever este método na classe derivada para fornecer uma rotina de inicialização personalizada. Esta implementação base do InitializeCell método é frequentemente chamada do método sobreposto para redefinir propriedades comuns a todas as células nas colunas derivadas da DataGridColumn classe.

Nesta implementação, o InitializeCell método reinicia apenas as células do cabeçalho e do rodapé. Outros tipos de células não são afetados por este método.

Quando a ordenação está ativada (definindo a AllowSorting propriedade para true), um LinkButton controlo é adicionado à célula do cabeçalho por defeito. Isto permite-te ordenar a coluna quando o LinkButton controlo é clicado. Se especificar uma imagem para a célula do cabeçalho (definindo a propriedade HeaderImageUrl ), é criado um ImageButton controlo em vez disso.

Quando a ordenação está desativada, o texto especificado pela HeaderText propriedade é apresentado na célula do cabeçalho. Se especificar uma imagem para a célula do cabeçalho (definindo a propriedade HeaderImageUrl ), um Image controlo é adicionado à célula do cabeçalho.

Como um navegador não apresenta uma célula vazia, se uma imagem não for exibida na célula do cabeçalho e a HeaderText propriedade não estiver definida, uma entidade HTML de espaço contínuo ( ) é exibida na célula do cabeçalho. De forma semelhante, se a célula de rodapé não tiver conteúdo (se a FooterText propriedade não estiver definida), uma entidade HTML de espaço contínuo é exibida na célula de rodapé.

Note

Este método é frequentemente utilizado por desenvolvedores de controlo.

Aplica-se a