System.Generics.Collections.TDictionary.Add

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi

Exemples de code