ListViewCancelEventArgs.ItemIndex Eigenschaft

Definition

Ruft den Index des Elements mit der Schaltfläche Abbrechen ab, durch die das Ereignis ausgelöst wurde.

public:
 property int ItemIndex { int get(); };
public int ItemIndex { get; }
member this.ItemIndex : int
Public ReadOnly Property ItemIndex As Integer

Eigenschaftswert

Int32

Der nullbasierte Index des Elements mit der Schaltfläche Abbrechen, durch die das Ereignis ausgelöst wurde.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie die ItemIndex Eigenschaft verwenden, um den Index des Bearbeitungselements zu bestimmen, das die Schaltfläche "Abbrechen" enthält, auf die der Benutzer geklickt wurde. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ListViewCancelEventArgs Klasse bereitgestellt wird.

protected void ContactsListView_ItemCanceling(object sender, ListViewCancelEventArgs e)
{
  //Check the operation that raised the event
  if (e.CancelMode == ListViewCancelMode.CancelingEdit)
  {
    // The update operation was canceled. Display the 
    // primary key of the item.
    Message.Text = "Update for the ContactID " + 
      ContactsListView.DataKeys[e.ItemIndex].Value.ToString()  + " canceled.";
  }
  else
  {
    Message.Text = "Insert operation canceled."; 
  }
}
Protected Sub ContactsListView_ItemCanceling(ByVal sender As Object, _
                                             ByVal e As ListViewCancelEventArgs)
  'Check the operation that raised the event
  If (e.CancelMode = ListViewCancelMode.CancelingEdit) Then
    ' The update operation was canceled. Display the 
    ' primary key of the item.
    Message.Text = "Update for the ContactID " & _
      ContactsListView.DataKeys(e.ItemIndex).Value.ToString() & " canceled."
  Else
    Message.Text = "Insert operation canceled."
  End If

End Sub

Hinweise

Verwenden Sie die ItemIndex Eigenschaft, um den Index des Elements zu bestimmen, das die Schaltfläche "Abbrechen" enthält, auf die der Benutzer geklickt hat. Der Elementindex wird häufig verwendet, um das Element aus Items der Auflistung des ListView Steuerelements abzurufen, wodurch Sie auf die Eigenschaften des Elements zugreifen können.

Wenn die Eigenschaft auf ListViewCancelMode.CancelingInsert"" festgelegt ist, ist der CancelMode Wert der ItemIndex Eigenschaft immer -1.

Gilt für

Siehe auch