ListView.EditIndex Propriété
Définition
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.
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, setPublic Overridable Property EditIndex As IntegerValeur de propriété
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
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 s’affiche 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 le avec des EditItemTemplate contrôles liés aux données pour permettre aux utilisateurs de modifier les valeurs de l’élément. Pour passer du mode é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 en cours de modification ou lorsque vous ajoutez une fonctionnalité d’édition personnalisée 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 sur Edit.
