System.Generics.Collections.TDictionary.Add
Delphi
procedure Add(const Key: K; const Value: V);
C++
void __fastcall Add(const K Key, const V Value);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
public | System.Generics.Collections.pas System.Generics.Collections.hpp |
System.Generics.Collections | TDictionary |
説明
キーと値のペアを追加します。
Add は、キーとそれに対応する値をディクショナリに追加します。 キーと値の両方が nil の可能性があります。
キーがディクショナリに既に存在する場合、例外が発生します。
OnKeyNotify イベントと OnValueNotify イベントは、エントリがディクショナリに追加されたことを示すために発生します。
Items プロパティは、すべての ディクショナリ エントリを一覧表示します。 Items プロパティに直接インデックスを付けることによって、値を設定したり取得することもできます。 たとえば、以下のように値を設定できます。
Items[key] := value;
この方法で値を設定すると、既存のキーに対する値が上書きされますが、例外は発生しません。