System.Generics.Collections.TDictionary.Add
Delphi
procedure Add(const Key: K; const Value: V);
C++
void __fastcall Add(const K Key, const V Value);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
public | System.Generics.Collections.pas System.Generics.Collections.hpp |
System.Generics.Collections | TDictionary |
Description
Ajoute une paire clé-valeur.
Add ajoute une clé et sa valeur correspondante dans le dictionnaire. La clé et la valeur peuvent toutes les deux valoir nil.
Si la clé existe déjà dans le dictionnaire, une exception est déclenchée.
Un événement OnKeyNotify et un événement OnValueNotify surviennent en indiquant qu'une entrée a été ajoutée au dictionnaire.
La propriété Items liste toutes les entrées du dictionnaire. Vous pouvez aussi définir et obtenir des valeurs en indexant directement la propriété Items. Par exemple, vous pouvez définir une valeur de la façon suivante :
Items[key] := value;
Définir la valeur de cette façon redéfinit la valeur d'une clé existante, mais ne déclenche pas une exception.