DataControlField.InitializeCell Methode

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee voegt u tekst of besturingselementen toe aan de verzameling besturingselementen van een cel.

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)

Parameters

cell
DataControlFieldCell

Een DataControlFieldCell met de tekst of besturingselementen van de DataControlField.

cellType
DataControlCellType

Een van de DataControlCellType waarden.

rowState
DataControlRowState

Een van de DataControlRowState waarden, waarmee de status van de rij wordt opgegeven die de DataControlFieldCell.

rowIndex
Int32

De index van de rij waarin de DataControlFieldCell rij zich bevindt.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de InitializeCell methode implementeert voor een besturingselement dat is afgeleid van de DataControlField klasse. De RadioButtonField klasse geeft een gegevensgebonden keuzerondje weer voor elke rij in een GridView besturingselement. Wanneer de rij gegevens weergeeft aan een gebruiker en zich niet in de bewerkingsmodus bevindt, wordt het RadioButton besturingselement uitgeschakeld. Wanneer de rij zich in de bewerkingsmodus bevindt, bijvoorbeeld wanneer de gebruiker ervoor kiest om een rij in het GridView besturingselement bij te werken, wordt het RadioButton besturingselement weergegeven als ingeschakeld, zodat erop kan worden geklikt. In dit voorbeeld worden bitsgewijze AND-operators gebruikt, omdat de rijstatus een combinatie van een of meer DataControlRowState waarden kan zijn.

// 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

Opmerkingen

Typen die zijn afgeleid van het implementeren van DataControlField de InitializeCell methode om tekst en besturingselementen toe te voegen aan een DataControlFieldCell object dat deel uitmaakt van een gegevensbesturingselement dat gebruikmaakt van tabellen om een gebruikersinterface (UI) weer te geven. Met deze gegevensbesturingselementen wordt de volledige rij van de tabelstructuur per rij gemaakt wanneer hun respectieve CreateChildControls methoden worden aangeroepen. De InitializeCell methode wordt aangeroepen door de InitializeRow methode van gegevensbesturingselementen zoals DetailsView en GridView.

Roep deze methode aan wanneer u een aangepast gegevensgebonden besturingselement schrijft dat gebruikmaakt DataControlFieldCell van objecten om de cellen van de tabelstructuur te initialiseren met gegevens of besturingselementen. Implementeer deze methode wanneer u een klasse schrijft die is afgeleid van DataControlField.

Van toepassing op

Zie ook