DataGridColumn.InitializeCell(TableCell, Int32, ListItemType) Metodo

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Fornisce l'implementazione di base per reimpostare lo stato iniziale della cella specificata di una colonna derivata dalla classe 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)

Parametri

cell

TableCell

Oggetto TableCell che rappresenta la cella da ripristinare.

columnIndex

Int32

Numero della colonna in cui si trova la cella.

itemType

ListItemType

Uno dei valori di ListItemType.

Commenti

Il InitializeCell metodo fornisce l'implementazione di base per reimpostare la cella specificata da una colonna derivata dalla DataGridColumn classe allo stato iniziale. Il metodo non viene chiamato in modo diretto, Questo metodo viene invece ereditato da una classe di colonna derivata, che può quindi essere usata per reimpostare una cella nella colonna del tipo derivato. Facoltativamente, è possibile eseguire l'override di questo metodo nella classe derivata per fornire una routine di inizializzazione personalizzata. Questa implementazione di base del InitializeCell metodo viene spesso chiamata dal metodo sottoposto a override per reimpostare le proprietà comuni a tutte le celle nelle colonne derivate dalla DataGridColumn classe .

In questa implementazione, il InitializeCell metodo reimposta solo le celle di intestazione e piè di pagina. Altri tipi di celle non sono interessati da questo metodo.

Quando l'ordinamento è abilitato (impostando la AllowSorting proprietà su true), viene aggiunto un LinkButton controllo alla cella di intestazione per impostazione predefinita. In questo modo è possibile ordinare la colonna quando si fa clic sul LinkButton controllo . Se si specifica un'immagine per la cella di intestazione (impostando la HeaderImageUrl proprietà), viene invece creato un ImageButton controllo .

Quando l'ordinamento è disabilitato, il testo specificato dalla HeaderText proprietà viene visualizzato nella cella di intestazione. Se si specifica un'immagine per la cella di intestazione (impostando la HeaderImageUrl proprietà), viene aggiunto un Image controllo alla cella di intestazione.

Poiché un browser non visualizzerà una cella vuota, se un'immagine in non viene visualizzata nella cella di intestazione e la HeaderText proprietà non è impostata, nella cella di intestazione viene visualizzata un'entità HTML di spazio non di interruzione ( ). Analogamente, se la cella del piè di pagina non ha contenuto (se la FooterText proprietà non è impostata), nella cella del piè di pagina viene visualizzata un'entità HTML di spazio non di interruzione.

Nota

Questo metodo viene comunemente usato dagli sviluppatori di controlli.