CollectionBase.OnInsertComplete Method (System.Collections)

.NET Framework Class Library

CollectionBase..::.OnInsertComplete Method

Performs additional custom processes after inserting a new element into the CollectionBase instance.

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

Syntax

Visual Basic (Declaration)

Protected Overridable Sub OnInsertComplete ( _
    index As Integer, _
    value As Object _
)

Visual Basic (Usage)

Dim index As Integer
Dim value As Object

Me.OnInsertComplete(index, value)

protected virtual void OnInsertComplete(
    int index,
    Object value
)

Visual C++

protected:
virtual void OnInsertComplete(
    int index, 
    Object^ value
)

JScript

protected function OnInsertComplete(
    index : int, 
    value : Object
)

Parameters

index: Type: System..::.Int32
The zero-based index at which to insert value.

value: Type: System..::.Object
The new value of the element at index.

Remarks

The default implementation of this method is intended to be overridden by a derived class to perform some action after the specified element is inserted.

The On* methods are invoked only on the instance returned by the List property, but not on the instance returned by the InnerList property.

The collection reverts back to its previous state if one of the following occurs:

The process fails.
This method is overridden to throw an exception.

The default implementation of this method is an O(1) operation.

Notes to Implementers:

This method allows implementers to define processes that must be performed after inserting the element into the underlying System.Collections..::.ArrayList. By defining this method, implementers can add functionality to inherited methods without having to override all other methods.

OnInsert is invoked before the standard Insert behavior, whereas OnInsertComplete is invoked after the standard Insert behavior.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Reference

CollectionBase Class

CollectionBase Members

System.Collections Namespace

OnInsert

OnSetComplete