ListViewCancelEventArgs.ItemIndex Propriedade

public:
 property int ItemIndex { int get(); };

public int ItemIndex { get; }

member this.ItemIndex : int

Public ReadOnly Property ItemIndex As Integer

Valor de Propriedade

O índice em base zero do item que contém o botão Cancelar que levantou o evento.

Exemplos

O exemplo seguinte mostra como usar a ItemIndex propriedade para determinar o índice do item de edição que contém o botão Cancelar que foi clicado pelo utilizador. Este exemplo de código faz parte de um exemplo maior fornecido para a ListViewCancelEventArgs classe.

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

Observações

Use a ItemIndex propriedade para determinar o índice do item que contém o botão Cancelar clicado pelo utilizador. O índice de itens é frequentemente usado para recuperar o item da Items coleção do ListView controlo, o que permite aceder às propriedades do item.

Quando a CancelMode propriedade é definida para ListViewCancelMode.CancelingInsert, o valor da ItemIndex propriedade é sempre -1.

Ver também

• ListView
• Items
• ItemCanceling
• Visão Geral da Tecnologia: O Controlo ListView