ListView.EditIndex Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Index des Elements ab, das bearbeitet wird, oder legt diesen fest.

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

Eigenschaftswert

Int32

Der nullbasierte Index des bearbeiteten Elements. Der Standardwert ist -1. Damit wird angegeben, dass kein Element bearbeitet wird.

Ausnahmen

ArgumentOutOfRangeException

Die EditIndex-Eigenschaft wird auf einen Wert kleiner als –1 festgelegt.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die EditIndex -Eigenschaft verwendet wird, um zu bestimmen, ob sich ein Element im Bearbeitungsmodus im ListView Steuerelement befindet. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ListViewDataItem-Klasse bereitgestellt wird.

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

Hinweise

Sie können die EditIndex -Eigenschaft verwenden, um programmgesteuert anzugeben oder zu bestimmen, welches Element in einem ListView Steuerelement bearbeitet werden soll. Wenn diese Eigenschaft auf den Index eines Elements im Steuerelement festgelegt ist, wird dieses Element im Bearbeitungsmodus angezeigt. Im Bearbeitungsmodus wird das Element mithilfe der EditItemTemplate Vorlage anstelle der ItemTemplate Vorlage gerendert. Sie können die EditItemTemplate mit datengebundenen Steuerelementen auffüllen, damit Benutzer Werte für das Element ändern können. Um vom Bearbeitungsmodus in den Anzeigemodus zu wechseln, legen Sie diese Eigenschaft auf -1 fest.

Die EditIndex -Eigenschaft wird in der Regel verwendet, wenn Sie programmgesteuert bestimmen müssen, welches Element bearbeitet wird, oder wenn Sie dem ListView Steuerelement benutzerdefinierte Bearbeitungsfunktionen hinzufügen. Das ListView Steuerelement verfügt über eine integrierte Bearbeitungsfunktion, die ein Element automatisch in den Bearbeitungsmodus versetzt, wenn Sie der Elementvorlage eine Schaltfläche hinzufügen, deren CommandName Eigenschaft auf Editfestgelegt ist.

Gilt für:

Freigeben über