DataControlField.InitializeCell Metoda

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Přidá text nebo ovládací prvky do kolekce ovládacích prvků buňky.

public:
 virtual void InitializeCell(System::Web::UI::WebControls::DataControlFieldCell ^ cell, System::Web::UI::WebControls::DataControlCellType cellType, System::Web::UI::WebControls::DataControlRowState rowState, int rowIndex);
public virtual void InitializeCell(System.Web.UI.WebControls.DataControlFieldCell cell, System.Web.UI.WebControls.DataControlCellType cellType, System.Web.UI.WebControls.DataControlRowState rowState, int rowIndex);
abstract member InitializeCell : System.Web.UI.WebControls.DataControlFieldCell * System.Web.UI.WebControls.DataControlCellType * System.Web.UI.WebControls.DataControlRowState * int -> unit
override this.InitializeCell : System.Web.UI.WebControls.DataControlFieldCell * System.Web.UI.WebControls.DataControlCellType * System.Web.UI.WebControls.DataControlRowState * int -> unit
Public Overridable Sub InitializeCell (cell As DataControlFieldCell, cellType As DataControlCellType, rowState As DataControlRowState, rowIndex As Integer)

Parametry

cell
DataControlFieldCell

A DataControlFieldCell , který obsahuje text nebo ovládací prvky DataControlField.

cellType
DataControlCellType

Jedna z DataControlCellType hodnot.

rowState
DataControlRowState

Jedna z DataControlRowState hodnot určující stav řádku, který obsahuje DataControlFieldCellhodnotu .

rowIndex
Int32

Index řádku, ve který DataControlFieldCell je obsažen.

Příklady

Následující příklad kódu ukazuje, jak implementovat metodu InitializeCell pro ovládací prvek, který je odvozen z DataControlField třídy. Třída RadioButtonField vykresluje přepínač vázaný na data pro každý řádek GridView ovládacího prvku. Pokud řádek zobrazuje data uživateli a není v režimu úprav, RadioButton ovládací prvek je zakázaný. Pokud je řádek v režimu úprav, například když se uživatel rozhodne aktualizovat řádek v ovládacím GridView prvku, zobrazí se ovládací prvek jako povolený, RadioButton aby bylo možné na něj kliknout. Tento příklad používá bitové operátory AND, protože stav řádku může být kombinací jedné nebo více DataControlRowState hodnot.

// This method adds a RadioButton control and any other 
// content to the cell's Controls collection.
protected override void InitializeDataCell
    (DataControlFieldCell cell, DataControlRowState rowState) {

  RadioButton radio = new RadioButton();

  // If the RadioButton is bound to a DataField, add
  // the OnDataBindingField method event handler to the
  // DataBinding event.
  if (DataField.Length != 0) {
    radio.DataBinding += new EventHandler(this.OnDataBindField);
  }

  radio.Text = this.Text;

  // Because the RadioButtonField is a BoundField, it only
  // displays data. Therefore, unless the row is in edit mode,
  // the RadioButton is displayed as disabled.
  radio.Enabled = false;
  // If the row is in edit mode, enable the button.
  if ((rowState & DataControlRowState.Edit) != 0 ||
      (rowState & DataControlRowState.Insert) != 0) {
    radio.Enabled = true;
  }

  cell.Controls.Add(radio);
}

' This method adds a RadioButton control and any other 
' content to the cell's Controls collection.
Protected Overrides Sub InitializeDataCell( _
    ByVal cell As DataControlFieldCell, _
    ByVal rowState As DataControlRowState)

    Dim radio As New RadioButton()

    ' If the RadioButton is bound to a DataField, add
    ' the OnDataBindingField method event handler to the
    ' DataBinding event.
    If DataField.Length <> 0 Then
        AddHandler radio.DataBinding, AddressOf Me.OnDataBindField
    End If

    radio.Text = Me.Text

    ' Because the RadioButtonField is a BoundField, it only 
    ' displays data. Therefore, unless the row is in edit mode, 
    ' the RadioButton is displayed as disabled.
    radio.Enabled = False
    ' If the row is in edit mode, enable the button.
    If (rowState And DataControlRowState.Edit) <> 0 _
        OrElse (rowState And DataControlRowState.Insert) <> 0 Then
        radio.Enabled = True
    End If

    cell.Controls.Add(radio)
End Sub

Poznámky

Typy odvozené z DataControlField implementace InitializeCell metody pro přidání textu a ovládacích prvků do objektu, který patří do DataControlFieldCell ovládacího prvku dat, který používá tabulky k zobrazení uživatelského rozhraní. Tyto ovládací prvky dat vytvoří kompletní řádek struktury tabulky po řádku, když jsou volána jejich odpovídající CreateChildControls metody. Metoda InitializeCell je volána InitializeRow metodou ovládacích prvků dat, jako je a DetailsViewGridView.

Volání této metody při psaní vlastního ovládacího prvku vázaného na data, který používá DataControlFieldCell objekty k inicializaci buněk struktury tabulky s daty nebo ovládacími prvky. Implementujte tuto metodu při psaní třídy odvozené z DataControlField.

Platí pro

Viz také