DictionaryBase.OnGet(Object, Object) Méthode

Définition

Espace de noms:

System.Collections

Assemblys:

netstandard.dll, System.Collections.NonGeneric.dll

Source:

DictionaryBase.cs

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

Contenant Object 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 substitué 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 l’instance retournée par la Dictionary propriété, mais pas sur l’instance retournée 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 effectué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 renvoyer 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 le retourner.