DictionaryBase.OnGet(Object, Object) Méthode

Définition

Espace de noms:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Source:

DictionaryBase.cs

Obtient l'élément correspondant à la clé et la valeur spécifiées dans l'instance 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

Paramètres

key

Object

Clé de l'élément à obtenir.

currentValue

Object

Valeur actuelle de l'élément associé à key.

Retours

Object

Object contenant l'élément avec la clé et la valeur spécifiées.

Remarques

L’implémentation par défaut de cette méthode retourne currentValue. Il est destiné à être remplacé par une classe dérivée pour effectuer une action supplémentaire lorsque l’élément spécifié est récupéré.

Les méthodes On* sont appelées uniquement sur le instance retourné par la Dictionary propriété, mais pas sur le instance retourné par la InnerHashtable propriété.

L’implémentation par défaut de cette méthode est une O(1) opération.

Notes pour les héritiers

Cette méthode permet aux implémenteurs de définir des processus qui doivent être exécutés lors de l’exécution du comportement Get standard du sous-jacent Hashtable. En définissant cette méthode, les implémenteurs peuvent ajouter des fonctionnalités aux méthodes héritées sans avoir à remplacer toutes les autres méthodes.

OnGet(Object, Object) peut être utilisé pour spécifier les processus à effectuer avant de retourner la valeur récupérée à partir du sous-jacent Hashtable. Par exemple, les implémenteurs peuvent convertir la valeur en un autre type avant de la renvoyer.