ListViewCancelEventArgs.ItemIndex Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém o índice do item que contém o botão Cancelar que gerou o evento.
public:
property int ItemIndex { int get(); };
public int ItemIndex { get; }
member this.ItemIndex : int
Public ReadOnly Property ItemIndex As Integer
Valor da propriedade
O índice baseado em zero do item que contém o botão Cancelar que acionou o evento.
Exemplos
O exemplo a seguir 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 usuário. 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
Comentários
Use a ItemIndex propriedade para determinar o índice do item que contém o botão Cancelar clicado pelo usuário. O índice de item geralmente é usado para recuperar o item da Items coleção do controle , o ListView que permite que você acesse as propriedades do item.
Quando a CancelMode propriedade é definida como ListViewCancelMode.CancelingInsert
, o valor da ItemIndex propriedade é sempre -1.