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

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Fornece a implementação base para redefinir a célula especificada de uma coluna derivada da classe DataGridColumn para 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

Uma TableCell que representa a célula a ser redefinida.

columnIndex

Int32

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

itemType

ListItemType

Um dos valores de ListItemType.

Comentários

O InitializeCell método fornece a implementação base para redefinir a célula especificada de uma coluna derivada da classe para seu DataGridColumn estado inicial. Esse método não é chamado diretamente. Em vez disso, esse método é herdado por uma classe de coluna derivada, que pode ser usada para redefinir uma célula na coluna do tipo derivado. Opcionalmente, você pode substituir esse método na classe derivada para fornecer uma rotina de inicialização personalizada. Essa implementação base do InitializeCell método geralmente é chamada do método substituído para redefinir propriedades comuns a todas as células em colunas derivadas da DataGridColumn classe.

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

Quando a classificação é habilitada (definindo a AllowSorting propriedade como true), um LinkButton controle é adicionado à célula de cabeçalho por padrão. Isso permite que você classifique a coluna quando o LinkButton controle for clicado. Se você especificar uma imagem para a célula de cabeçalho (definindo a HeaderImageUrl propriedade), um ImageButton controle será criado em vez disso.

Quando a classificação é desabilitada, o texto especificado pela HeaderText propriedade é exibido na célula de cabeçalho. Se você especificar uma imagem para a célula de cabeçalho (definindo a HeaderImageUrl propriedade), um Image controle será adicionado à célula de cabeçalho.

Como um navegador não exibirá uma célula vazia, se uma imagem não for exibida na célula de cabeçalho e a HeaderText propriedade não estiver definida, uma entidade HTML de espaço não de quebra ( ) será exibida na célula de cabeçalho. Da mesma forma, se a célula rodapé não tiver nenhum conteúdo (se a FooterText propriedade não estiver definida), uma entidade HTML de espaço não-quebra será exibida na célula rodapé.

Observação

Esse método é comumente usado por desenvolvedores de controle.