ListChangedEventArgs Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Source:

ListChangedEventArgs.cs

Fornisce i dati per l'evento ListChanged.

public ref class ListChangedEventArgs : EventArgs

public class ListChangedEventArgs : EventArgs

type ListChangedEventArgs = class
    inherit EventArgs

Public Class ListChangedEventArgs
Inherits EventArgs

Ereditarietà

Object

EventArgs

ListChangedEventArgs

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo tipo. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento BindingSource.ListChanged . Questo report consente di apprendere quando si verifica l'evento e può essere utile per il debug. Per segnalare più eventi o eventi che si verificano di frequente, provare a sostituire MessageBox.Show o Console.WriteLine accodare il messaggio a un oggetto multilinea TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di tipo BindingSource denominata BindingSource1. Assicurarsi quindi che il gestore eventi sia associato all'evento BindingSource.ListChanged .

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

Commenti

Un ListChanged evento viene generato quando i dati in un oggetto IBindingList vengono modificati.

La NewIndex proprietà indica l'indice dell'elemento aggiunto, modificato o eliminato. Se un elemento è stato spostato, la NewIndex proprietà indica la nuova posizione dell'elemento e la OldIndex proprietà indica la posizione precedente.

Se un solo elemento è interessato da una modifica, il valore della OldIndex proprietà è -1.

Costruttori

ListChangedEventArgs(ListChangedType, Int32)	Inizializza una nuova istanza della classe ListChangedEventArgs fornendo il tipo di modifica e l'indice dell'elemento interessato.
ListChangedEventArgs(ListChangedType, Int32, Int32)	Inizializza una nuova istanza della classe ListChangedEventArgs dato il tipo della modifica, nonché il nuovo e il precedente indice dell'elemento spostato.
ListChangedEventArgs(ListChangedType, Int32, PropertyDescriptor)	Inizializza una nuova istanza della classe ListChangedEventArgs fornendo il tipo di modifica, l'indice dell'elemento interessato e un oggetto PropertyDescriptor che descrive l'elemento interessato.
ListChangedEventArgs(ListChangedType, PropertyDescriptor)	Inizializza una nuova istanza della classe ListChangedEventArgs dato il tipo di modifica e l'oggetto PropertyDescriptor interessato.

Proprietà

ListChangedType	Ottiene il tipo di modifica.
NewIndex	Ottiene l'indice dell'elemento interessato dalla modifica.
OldIndex	Ottiene il precedente indice di un elemento spostato.
PropertyDescriptor	Ottiene l'oggetto PropertyDescriptor aggiunto, modificato o eliminato.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• IBindingList
• Utilizzo degli eventi DataView