ListChangedEventArgs Classe
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.
Fornece dados para o evento de ListChanged .
public ref class ListChangedEventArgs : EventArgs
public class ListChangedEventArgs : EventArgs
type ListChangedEventArgs = class
inherit EventArgs
Public Class ListChangedEventArgs
Inherits EventArgs
- Herança
Exemplos
O exemplo de código a seguir demonstra o uso desse tipo. No exemplo, um manipulador de eventos relata a ocorrência do BindingSource.ListChanged evento. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine ou acrescentar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo BindingSource chamada BindingSource1
. Em seguida, verifique se o manipulador de eventos está associado ao BindingSource.ListChanged evento.
private void BindingSource1_ListChanged(Object sender, ListChangedEventArgs e) {
System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ListChangedType", e.ListChangedType );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "NewIndex", e.NewIndex );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "OldIndex", e.OldIndex );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "PropertyDescriptor", e.PropertyDescriptor );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "ListChanged Event" );
}
Private Sub BindingSource1_ListChanged(sender as Object, e as ListChangedEventArgs) _
Handles BindingSource1.ListChanged
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "ListChangedType", e.ListChangedType)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "NewIndex", e.NewIndex)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "OldIndex", e.OldIndex)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "PropertyDescriptor", e.PropertyDescriptor)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"ListChanged Event")
End Sub
Comentários
Um ListChanged evento é gerado quando os dados em um IBindingList são alterados.
A NewIndex propriedade indica o índice do item que foi adicionado, alterado ou excluído. Se um item foi movido, a NewIndex propriedade indica o novo local do item e a OldIndex propriedade indica o local antigo.
Se apenas um item for afetado por uma alteração, o valor da OldIndex propriedade será -1.
Construtores
ListChangedEventArgs(ListChangedType, Int32) |
Inicializa uma nova instância da classe ListChangedEventArgs considerando o tipo de alteração e o índice do item afetado. |
ListChangedEventArgs(ListChangedType, Int32, Int32) |
Inicializa uma nova instância da classe ListChangedEventArgs considerando o tipo de alteração e os índices antigo e novo do item que foi movido. |
ListChangedEventArgs(ListChangedType, Int32, PropertyDescriptor) |
Inicializa uma nova instância da classe ListChangedEventArgs considerando o tipo de alteração, o índice do item afetado e um PropertyDescriptor que descreve o item afetado. |
ListChangedEventArgs(ListChangedType, PropertyDescriptor) |
Inicializa uma nova instância da classe ListChangedEventArgs considerando o tipo de alteração e o PropertyDescriptor afetado. |
Propriedades
ListChangedType |
Obtém o tipo de alteração. |
NewIndex |
Obtém o índice do item afetado pela alteração. |
OldIndex |
Obtém o índice antigo de um item que foi movido. |
PropertyDescriptor |
Obtém o PropertyDescriptor que foi adicionado, alterado ou excluído. |
Métodos
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |