ListChangedEventArgs Classe

Definição

Fornece dados para o ListChanged evento.

public ref class ListChangedEventArgs : EventArgs
public class ListChangedEventArgs : EventArgs
type ListChangedEventArgs = class
    inherit EventArgs
Public Class ListChangedEventArgs
Inherits EventArgs
Herança
ListChangedEventArgs

Exemplos

O seguinte exemplo de código demonstra o uso deste tipo. No exemplo, um gestor de eventos reporta a ocorrência do BindingSource.ListChanged evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo BindingSource chamada BindingSource1. Depois, certifique-se de que o gestor 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

Observações

Um ListChanged evento é gerado quando os dados em um IBindingList mudam.

A NewIndex propriedade indica o índice do item que foi adicionado, alterado ou eliminado. Se um item foi movido, a NewIndex propriedade indica a nova localização do item e a OldIndex propriedade indica a localização antiga.

Se apenas um item for afetado por uma alteração, o OldIndex valor da propriedade é -1.

Construtores

Name Description
ListChangedEventArgs(ListChangedType, Int32, Int32)

Inicializa uma nova instância da ListChangedEventArgs classe dado o tipo de alteração e o índice antigo e novo do item que foi movido.

ListChangedEventArgs(ListChangedType, Int32, PropertyDescriptor)

Inicializa uma nova instância da ListChangedEventArgs classe dado o tipo de alteração, o índice do item afetado e a PropertyDescriptor que descreve o item afetado.

ListChangedEventArgs(ListChangedType, Int32)

Inicializa uma nova instância da ListChangedEventArgs classe dado o tipo de alteração e o índice do item afetado.

ListChangedEventArgs(ListChangedType, PropertyDescriptor)

Inicializa uma nova instância da ListChangedEventArgs classe dado o tipo de alteração e o PropertyDescriptor afetado.

Propriedades

Name Description
ListChangedType

Recebe o tipo de mudança.

NewIndex

Obtém o índice do item afetado pela alteração.

OldIndex

Obtém o índice antigo de um item que foi movido.

PropertyDescriptor

Recebe o PropertyDescriptor que foi adicionado, alterado ou eliminado.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também