CollectionBase.OnInsertComplete(Int32, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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);
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.