DictionaryBase.OnGet(Object, Object) Método

Definição

Namespace:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Origem:

DictionaryBase.cs

Obtém o elemento com a chave e o valor especificados à instância de DictionaryBase.

protected:
 virtual System::Object ^ OnGet(System::Object ^ key, System::Object ^ currentValue);

protected virtual object? OnGet (object key, object? currentValue);

abstract member OnGet : obj * obj -> obj
override this.OnGet : obj * obj -> obj

Protected Overridable Function OnGet (key As Object, currentValue As Object) As Object

Parâmetros

key

Object

A chave do elemento a obter.

currentValue

Object

O valor atual do elemento associado a key.

Retornos

Object

Um Object que contém o elemento com a chave e o valor especificados.

Comentários

A implementação padrão desse método retorna currentValue. Ele deve ser substituído por uma classe derivada para executar uma ação adicional quando o elemento especificado for recuperado.

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

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 ao executar o comportamento padrão Get do subjacente Hashtable. Ao definir esse método, os implementadores podem adicionar funcionalidade aos métodos herdados sem precisar substituir todos os outros métodos.

OnGet(Object, Object) pode ser usado para especificar processos a serem executados antes de retornar o valor recuperado do subjacente Hashtable. Por exemplo, os implementadores podem converter o valor em outro tipo antes de devolvê-lo.