次の方法で共有


CollectionBase.OnInsertComplete(Int32, Object) メソッド

定義

CollectionBase インスタンスに新しい要素を挿入した後、追加のカスタム プロセスを実行します。

protected:
 virtual void OnInsertComplete(int index, System::Object ^ value);
protected virtual void OnInsertComplete(int index, object value);
protected virtual void OnInsertComplete(int index, object? value);
abstract member OnInsertComplete : int * obj -> unit
override this.OnInsertComplete : int * obj -> unit
Protected Overridable Sub OnInsertComplete (index As Integer, value As Object)

パラメーター

index
Int32

valueを挿入する位置を示す 0 から始まるインデックス。

value
Object

indexの要素の新しい値。

注釈

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

On* メソッドは、 List プロパティによって返されたインスタンスでのみ呼び出されますが、 InnerList プロパティによって返されるインスタンスでは呼び出されません。

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

  • プロセスは失敗します。

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

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

注意 (継承者)

このメソッドを使用すると、実装者は、基になる ArrayListに要素を挿入した後に実行する必要があるプロセスを定義できます。 このメソッドを定義することで、実装者は、他のすべてのメソッドをオーバーライドしなくても、継承されたメソッドに機能を追加できます。

OnInsert(Int32, Object) は標準の Insert 動作の前に呼び出されますが、 OnInsertComplete(Int32, Object) は標準の Insert 動作の後に呼び出されます。

適用対象

こちらもご覧ください