DataControlField.InitializeCell Méthode

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute du texte ou des contrôles à la collection de contrôles d'une cellule.

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)

Paramètres

cell: DataControlFieldCell

DataControlFieldCell qui contient le texte ou les contrôles du DataControlField.

cellType: DataControlCellType

Une des valeurs de l'objet DataControlCellType.

rowState: DataControlRowState

Une des valeurs DataControlRowState spécifiant l'état de la ligne qui contient DataControlFieldCell.

rowIndex: Int32

Index de la ligne contenant DataControlFieldCell.

Exemples

L’exemple de code suivant montre comment implémenter la InitializeCell méthode pour un contrôle qui dérive de la DataControlField classe. La RadioButtonField classe affiche une case d’option liée aux données pour chaque ligne d’un GridView contrôle. Lorsque la ligne affiche des données à un utilisateur et n’est pas en mode édition, le RadioButton contrôle est désactivé. Lorsque la ligne est en mode édition, par exemple lorsque l’utilisateur choisit de mettre à jour une ligne dans le GridView contrôle, le RadioButton contrôle est affiché comme activé afin qu’il puisse être cliqué. Cet exemple utilise des opérateurs AND au niveau du bit, car l’état de ligne peut être une combinaison d’une ou plusieurs DataControlRowState valeurs.

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

Remarques

Types dérivés de l’implémentation de la InitializeCell méthode pour ajouter du texte et des contrôles à un objet qui appartient à un DataControlFieldCell contrôle de DataControlField données qui utilise des tables pour afficher une interface utilisateur (INTERFACE utilisateur). Ces contrôles de données créent la ligne de structure de table complète par ligne lorsque leurs méthodes respectives CreateChildControls sont appelées. La InitializeCell méthode est appelée par la InitializeRow méthode des contrôles de données tels que DetailsView et GridView.

Appelez cette méthode lorsque vous écrivez un contrôle lié aux données personnalisé qui utilise DataControlFieldCell des objets pour initialiser les cellules de la structure de table avec des données ou des contrôles. Implémentez cette méthode lorsque vous écrivez une classe dérivée de DataControlField.

S’applique à

Voir aussi

ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)