CollectionChangeEventArgs Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Origine:

CollectionChangeEventArgs.cs

Fornisce i dati per l'evento CollectionChanged.

public ref class CollectionChangeEventArgs : EventArgs

public class CollectionChangeEventArgs : EventArgs

type CollectionChangeEventArgs = class
    inherit EventArgs

Public Class CollectionChangeEventArgs
Inherits EventArgs

Ereditarietà

Object

EventArgs

CollectionChangeEventArgs

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo tipo. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento AutoCompleteStringCollection.CollectionChanged . 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 AutoCompleteStringCollection denominata AutoCompleteStringCollection1. Assicurarsi quindi che il gestore eventi sia associato all'evento AutoCompleteStringCollection.CollectionChanged .

private void AutoCompleteStringCollection1_CollectionChanged(Object sender, CollectionChangeEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Action", e.Action );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Element", e.Element );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "CollectionChanged Event" );
}

Private Sub AutoCompleteStringCollection1_CollectionChanged(sender as Object, e as CollectionChangeEventArgs) _ 
     Handles AutoCompleteStringCollection1.CollectionChanged

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Action", e.Action)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Element", e.Element)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"CollectionChanged Event")

End Sub

Commenti

Un CollectionChanged evento viene generato quando si modificano gli elementi in una raccolta, ad esempio aggiungendo un elemento a una raccolta o rimuovendo un elemento dalla raccolta. Questo evento non viene generato quando un singolo elemento modifica il relativo valore.

Costruttori

CollectionChangeEventArgs(CollectionChangeAction, Object)

Inizializza una nuova istanza della classe CollectionChangeEventArgs.

Proprietà

Action	Ottiene un'azione che specifica il tipo di modifica apportata all'insieme.
Element	Ottiene l’istanza dell'insieme con la modifica.

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

• CollectionChanged
• CollectionChangeEventHandler
• CollectionChangeAction