ListView.EditIndex, propriété
Mise à jour : novembre 2007
Obtient ou définit l'index de l'élément en cours de modification.
Assembly : System.Web.Extensions (dans System.Web.Extensions.dll)
/** @property */ public int get_EditIndex() /** @property */ public void set_EditIndex(int value)
public function get EditIndex () : int public function set EditIndex (value : int)
<asp:ListView EditIndex="Int32" />
Valeur de propriété
Type : System.Int32Index 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).
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | La propriété EditIndex est définie avec une valeur inférieure à -1. |
Vous pouvez utiliser la propriété EditIndex pour spécifier ou déterminer par programme quel élément modifier dans un contrôle ListView. Lorsque cette propriété a pour valeur 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 restitué en utilisant le modèle EditItemTemplate au lieu du modèle ItemTemplate. Vous pouvez remplir le EditItemTemplate avec des contrôles liés aux données pour permettre aux utilisateurs de modifier des valeurs pour l'élément. Pour passer du mode Édition au mode d'affichage, affectez la valeur -1 à cette propriété.
La propriété EditIndex est généralement utilisée lorsque vous devez déterminer par programme l'élément à modifier ou lorsque vous ajoutez une fonctionnalité de modification personnalisée au contrôle ListView. Le contrôle ListView a une fonctionnalité de modification intégrée qui met automatiquement un élément en mode Édition si vous ajoutez un bouton au modèle d'élément dont la propriété CommandName a la valeur Edit.
L'exemple suivant montre comment utiliser la propriété EditIndex pour déterminer si un élément est en mode Édition dans le contrôle ListView. Ce code fait partie d'un exemple plus complet fourni pour la classe ListViewDataItem.
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); } } }
Windows Vista, Windows XP SP2, Windows Server 2003
Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
