CollectionBase.OnSetComplete メソッド

.NET Framework クラス ライブラリ リファレンス

CollectionBase.OnSetComplete メソッド

CollectionBase インスタンスに値を設定した後に、追加のカスタム プロセスを実行します。

名前空間: System.Collections
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Sub
 OnSetComplete ( _
    index As Integer, _
    oldValue As Object, _
    newValue As Object _
)

Visual Basic (使用法)

Dim index As Integer
Dim oldValue As Object
Dim newValue As Object

Me.OnSetComplete(index, oldValue, newValue)

C#

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

C++

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

J#

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

JScript

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

パラメータ

index

oldValue が存在する位置の、0 から始まるインデックス番号。

oldValue

newValue で置換する値。

newValue

index にある要素の新しい値。

解説

このメソッドの既定の実装は、指定した要素の設定後にアクションを実行するために、派生クラスによってオーバーライドされます。

On* メソッドは、List プロパティによって返されたインスタンスに対してだけ呼び出され、InnerList プロパティによって返されたインスタンスに対しては呼び出されません。

次のいずれかの場合は、コレクションは以前の状態に戻ります。

• プロセスが失敗した場合。

• このメソッドが、例外をスローするためにオーバーライドされた場合。

このメソッドの既定の実装は O(1) 操作です。

実装時の注意 このメソッドを使用すると、基になる System.Collections.ArrayList に指定した要素を設定した後に実行する必要があるプロセスを定義できます。このメソッドを定義すると、他のすべてのメソッドをオーバーライドしなくても、継承されたメソッドに機能を追加できます。 OnSet は標準の Set 操作の前に呼び出され、OnSetComplete は標準の Set 操作の後に呼び出されます。

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
CollectionBase クラス
CollectionBase メンバ
System.Collections 名前空間
OnSet
OnInsertComplete