CollectionChangeEventArgs-Klasse

Ein CollectionChanged-Ereignis wird ausgelöst, wenn Sie eine Auflistung hinsichtlich der darin enthaltenen Elemente ändern, z. B. indem Sie der Auflistung ein Element hinzufügen oder ein Element aus dieser entfernen. Dieses Ereignis wird nicht ausgelöst, wenn der Wert eines einzelnen Elements geändert wird.

Hinweis

Das auf diesen Typ oder Member angewendete HostProtectionAttribute-Attribut besitzt den folgenden Resources-Eigenschaftswert: SharedState. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder einer URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute.

Im folgenden Codebeispiel wird die Verwendung dieses Typs veranschaulicht. Im Beispiel meldet ein Ereignishandler das Eintreten des AutoCompleteStringCollection.CollectionChanged-Ereignisses. Dieser Bericht hilft Ihnen, zu erlernen, wenn das Ereignis eintritt und kann Ihnen beim Debuggen helfen. Um einen Bericht für mehrere Ereignisse oder häufig eintretende Ereignisse zu erstellen, sollten Sie erwägen, MessageBox.Show durch Console.WriteLine zu ersetzen oder die Meldung an eine mehrzeilige TextBox anzufügen.

Um den Beispielcode auszuführen, fügen Sie diesen in ein Projekt ein, das eine Instanz vom Typ AutoCompleteStringCollection namens AutoCompleteStringCollection1 enthält. Stellen Sie dann sicher, dass der Ereignishandler dem AutoCompleteStringCollection.CollectionChanged-Ereignis zugeordnet ist.

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" );
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz