ListView.EditIndex Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.Extensions.dll

Obtient ou définit l'index de l'élément en cours de modification.

public:
 virtual property int EditIndex { int get(); void set(int value); };
public virtual int EditIndex { get; set; }
member this.EditIndex : int with get, set
Public Overridable Property EditIndex As Integer

Valeur de propriété

Int32

Index de base zéro de l'élément en cours de modification. La valeur par défaut est -1 (aucun élément n'est en cours de modification).

Exceptions

ArgumentOutOfRangeException

La valeur affectée à la propriété EditIndex est inférieure à -1.

Exemples

L’exemple suivant montre comment utiliser la EditIndex propriété pour déterminer si un élément est en mode édition dans le ListView contrôle. Cet exemple de code fait partie d’un exemple plus grand fourni pour la ListViewDataItem classe.

protected void ContactsListView_ItemDataBound(object sender, ListViewItemEventArgs e)
{

  //Verify there is an item being edited.
  if (ContactsListView.EditIndex >= 0)
  {

    //Get the item object.
    ListViewDataItem dataItem = (ListViewDataItem)e.Item;

    // Check for an item in edit mode.
    if (dataItem.DisplayIndex == ContactsListView.EditIndex)
    {

      // Preselect the DropDownList control with the Title value
      // for the current item.

      // Retrieve the underlying data item. In this example
      // the underlying data item is a DataRowView object.        
      DataRowView rowView = (DataRowView)dataItem.DataItem;

      // Retrieve the Title value for the current item. 
      String title = rowView["Title"].ToString();

      // Retrieve the DropDownList control from the current row. 
      DropDownList list = (DropDownList)dataItem.FindControl("TitlesList");

      // Find the ListItem object in the DropDownList control with the 
      // title value and select the item.
      ListItem item = list.Items.FindByText(title);
      list.SelectedIndex = list.Items.IndexOf(item);
                      
    }
  }
}

Protected Sub ContactsListView_ItemDataBound(ByVal sender As Object, ByVal e As ListViewItemEventArgs) 
    
  'Verify there is an item being edited.
  If ContactsListView.EditIndex >= 0 Then
    
    'Get the item object.
    Dim dataItem As ListViewDataItem = CType(e.Item, ListViewDataItem)
    
    ' Check for an item in edit mode.
    If dataItem.DisplayIndex = ContactsListView.EditIndex Then
        
      ' Preselect the DropDownList control with the Title value
      ' for the current item.
      ' Retrieve the underlying data item. In this example
      ' the underlying data item is a DataRowView object.        
      Dim rowView As DataRowView = CType(dataItem.DataItem, DataRowView)
      
      ' Retrieve the Title value for the current item. 
      Dim title As String = rowView("Title").ToString()
      
      ' Retrieve the DropDownList control from the current row. 
      Dim list As DropDownList = CType(dataItem.FindControl("TitlesList"), DropDownList)
      
      ' Find the ListItem object in the DropDownList control with the 
      ' title value and select the item.
      Dim item As ListItem = list.Items.FindByText(title)
      list.SelectedIndex = list.Items.IndexOf(item)
    End If 
  End If

End Sub

Remarques

Vous pouvez utiliser la EditIndex propriété pour spécifier ou déterminer par programmation l’élément d’un ListView contrôle à modifier. Lorsque cette propriété est définie sur l’index d’un élément dans le contrôle, cet élément est affiché en mode édition. En mode édition, l’élément est rendu à l’aide du EditItemTemplate modèle au lieu du ItemTemplate modèle. Vous pouvez remplir les EditItemTemplate contrôles liés aux données pour permettre aux utilisateurs de modifier des valeurs pour l’élément. Pour passer du mode d’édition au mode d’affichage, définissez cette propriété sur -1.

La EditIndex propriété est généralement utilisée lorsque vous devez déterminer par programmation quel élément est modifié ou lorsque vous ajoutez des fonctionnalités de modification personnalisées au ListView contrôle. Le ListView contrôle dispose d’une fonctionnalité d’édition intégrée qui place automatiquement un élément en mode édition si vous ajoutez un bouton au modèle d’élément dont CommandName la propriété est définie Edit.

S’applique à

Voir aussi