CollectionBase.OnInsertComplete(Int32, Object) Método

Definição

Namespace:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Origem:

CollectionBase.cs

Executa processos personalizados adicionais após inserir um novo elemento na instância de CollectionBase.

protected:
 virtual void OnInsertComplete(int index, System::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)

Parâmetros

index

Int32

O índice de base zero no qual o value será inserido.

value

Object

O novo valor do elemento em index.

Comentários

A implementação padrão desse método destina-se a ser substituída por uma classe derivada para executar alguma ação após a inserção do elemento especificado.

Os métodos On* são invocados apenas na instância retornada pela List propriedade , mas não na instância retornada pela InnerList propriedade .

A coleção será revertida para seu estado anterior se ocorrer um destes procedimentos:

• O processo falha.

• Esse método é substituído para gerar uma exceção.

A implementação padrão desse método é uma O(1) operação.

Notas aos Herdeiros

Esse método permite que os implementadores definam processos que devem ser executados depois de inserir o elemento no subjacente ArrayList. Ao definir esse método, os implementadores podem adicionar funcionalidade aos métodos herdados sem precisar substituir todos os outros métodos.

OnInsert(Int32, Object) é invocado antes do comportamento de Inserção padrão, enquanto OnInsertComplete(Int32, Object) é invocado após o comportamento de Inserção padrão.

Confira também

• OnInsert(Int32, Object)
• OnSetComplete(Int32, Object, Object)