ListView.EditIndex Свойство

Определение

Возвращает или задает индекс для редактируемого элемента.Gets or sets the index of the item being edited.

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

Значение свойства

Отсчитываемый с нуля индекс редактируемого элемента.The zero-based index of the item being edited. По умолчанию используется значение -1, показывающее, что элементы не редактируются.The default is -1, which indicates that no item is being edited.

Исключения

Свойству EditIndex присвоено значение меньше –1.The EditIndex property is set to a value less than -1.

Примеры

В следующем примере показано, как использовать EditIndex свойство, чтобы определить, находится ли элемент в режиме редактирования ListView в элементе управления.The following example shows how to use the EditIndex property to determine whether an item is in edit mode in the ListView control. Этот пример кода является частью большого примера, ListViewDataItem приведенного для класса.This code example is part of a larger example provided for the ListViewDataItem class.

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

Комментарии

Можно использовать EditIndex свойство, чтобы программно указать или определить, какой элемент ListView в элементе управления нужно изменить.You can use the EditIndex property to programmatically specify or determine which item in a ListView control to edit. Если для этого свойства задан индекс элемента в элементе управления, этот элемент отображается в режиме редактирования.When this property is set to the index of an item in the control, that item is displayed in edit mode. В режиме редактирования элемент подготавливается к просмотру с EditItemTemplate помощью шаблона, а ItemTemplate не шаблона.In edit mode, the item is rendered by using the EditItemTemplate template instead of the ItemTemplate template. Можно заполнить EditItemTemplate элементами управления с привязкой к данным, чтобы разрешить пользователям изменять значения для элемента.You can populate the EditItemTemplate with data-bound controls to enable users to modify values for the item. Чтобы переключиться из режима редактирования в режим экрана, присвойте этому свойству значение-1.To switch from edit mode to display mode, set this property to -1.

Свойство обычно используется, если необходимо программным образом определить, какой элемент редактируется, или добавить пользовательскую функциональность редактирования ListView в элемент управления. EditIndexThe EditIndex property is typically used when you have to programmatically determine which item is being edited, or when you are adding custom editing functionality to the ListView control. Элемент управления имеет встроенную функцию редактирования, которая автоматически помещает элемент в режим редактирования при добавлении кнопки в шаблон элемента, свойство которого CommandName имеет значение Edit. ListViewThe ListView control has a built-in editing feature that automatically puts an item in edit mode if you add a button to the item template whose CommandName property is set to Edit.

Применяется к

Дополнительно