CollectionBase.OnSetComplete-Methode

Artikel
08/20/2007

Führt zusätzliche benutzerdefinierte Prozesse nach dem Festlegen eines Werts in der CollectionBase-Instanz aus.

Namespace: System.Collections
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Protected Overridable Sub OnSetComplete ( _
    index As Integer, _
    oldValue As Object, _
    newValue As Object _
)
'Usage
Dim index As Integer
Dim oldValue As Object
Dim newValue As Object

Me.OnSetComplete(index, oldValue, newValue)

protected virtual void OnSetComplete (
    int index,
    Object oldValue,
    Object newValue
)

protected:
virtual void OnSetComplete (
    int index, 
    Object^ oldValue, 
    Object^ newValue
)

protected void OnSetComplete (
    int index, 
    Object oldValue, 
    Object newValue
)

protected function OnSetComplete (
    index : int, 
    oldValue : Object, 
    newValue : Object
)

Parameter

index
Der nullbasierte Index, an dem sich oldValue befindet.

oldValue
Der Wert, der durch newValue ersetzt werden soll.

newValue
Der neue Wert des Elements an index.

Hinweise

Überschreiben Sie die Standardimplementierung dieser Methode durch eine abgeleitete Klasse, wenn nach dem Festlegen des angegebenen Elements zusätzliche Aktionen ausgeführt werden sollen.

Die On*-Methoden werden lediglich für die von der List-Eigenschaft zurückgegebene Instanz aufgerufen, jedoch nicht für die von der InnerList-Eigenschaft zurückgegebene Instanz.

Die Auflistung wird in ihrem vorherigen Zustand wiederhergestellt, wenn eines der folgenden Ereignisse eintritt:

Der Prozess schlägt fehl.
Diese Methode wird überschrieben, um eine Ausnahme auszulösen.

Die Standardimplementierung dieser Methode ist ein O(1)-Vorgang.

Hinweise für Implementierer Mithilfe der Methode können während der Implementierung Prozesse definiert werden, die ausgeführt werden müssen, nachdem das Element in der zugrunde liegenden System.Collections.ArrayList festgelegt wurde. Durch eine Definition dieser Methode kann der Funktionsumfang vererbter Methoden bei der Implementierung erweitert werden, ohne alle anderen Methoden überschreiben zu müssen. OnSet wird vor dem Standardverhalten von Set aufgerufen, OnSetComplete hingegen nach dem Standardverhalten von Set.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

CollectionBase-Klasse
CollectionBase-Member
System.Collections-Namespace
OnSet
OnInsertComplete

Freigeben über