ListChangedEventArgs Class

Definition

Fornisce i dati per l'evento ListChanged.Provides data for the ListChanged event.

public ref class ListChangedEventArgs : EventArgs
public class ListChangedEventArgs : EventArgs
type ListChangedEventArgs = class
    inherit EventArgs
Public Class ListChangedEventArgs
Inherits EventArgs
Inheritance
ListChangedEventArgs

Examples

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo di questo tipo.The following code example demonstrates the use of this type. Nell'esempio, un gestore eventi segnala l'occorrenza dell'evento BindingSource.ListChanged.In the example, an event handler reports on the occurrence of the BindingSource.ListChanged event. Questo report consente di apprendere quando si verifica l'evento e può facilitare il debug.This report helps you to learn when the event occurs and can assist you in debugging. Per creare report su più eventi o sugli eventi che si verificano di frequente, è consigliabile sostituire MessageBox.Show con Console.WriteLine o accodare il messaggio a una TextBoxa più righe.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto che contiene un'istanza di tipo BindingSource BindingSource1denominata.To run the example code, paste it into a project that contains an instance of type BindingSource named BindingSource1. Assicurarsi quindi che il gestore eventi sia associato all'evento BindingSource.ListChanged.Then ensure that the event handler is associated with the BindingSource.ListChanged event.

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

Remarks

Un evento ListChanged viene generato quando i dati di un IBindingList cambiano.A ListChanged event is raised when the data in an IBindingList changes.

La proprietà NewIndex indica l'indice dell'elemento aggiunto, modificato o eliminato.The NewIndex property indicates the index of the item that was added, changed, or deleted. Se un elemento è stato spostato, la proprietà NewIndex indica la nuova posizione dell'elemento e la proprietà OldIndex indica la posizione precedente.If an item was moved, the NewIndex property indicates the new location of the item and the OldIndex property indicates the old location.

Se una modifica influisce su un solo elemento, il valore della proprietà OldIndex è-1.If only one item is affected by a change, the OldIndex property value is -1.

Constructors

ListChangedEventArgs(ListChangedType, Int32)

Inizializza una nuova istanza della classe ListChangedEventArgs fornendo il tipo di modifica e l'indice dell'elemento interessato.Initializes a new instance of the ListChangedEventArgs class given the type of change and the index of the affected item.

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.Initializes a new instance of the ListChangedEventArgs class given the type of change and the old and new index of the item that was moved.

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.Initializes a new instance of the ListChangedEventArgs class given the type of change, the index of the affected item, and a PropertyDescriptor describing the affected item.

ListChangedEventArgs(ListChangedType, PropertyDescriptor)

Inizializza una nuova istanza della classe ListChangedEventArgs dato il tipo di modifica e l'oggetto PropertyDescriptor interessato.Initializes a new instance of the ListChangedEventArgs class given the type of change and the PropertyDescriptor affected.

Properties

ListChangedType

Ottiene il tipo di modifica.Gets the type of change.

NewIndex

Ottiene l'indice dell'elemento interessato dalla modifica.Gets the index of the item affected by the change.

OldIndex

Ottiene il precedente indice di un elemento spostato.Gets the old index of an item that has been moved.

PropertyDescriptor

Ottiene l'oggetto PropertyDescriptor aggiunto, modificato o eliminato.Gets the PropertyDescriptor that was added, changed, or deleted.

Methods

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also