System.Generics.Collections.TDictionary.Add

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

procedure Add(const Key: TKey; const Value: TValue);

C++

void __fastcall Add(const TKey Key, const TValue 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;

この方法で値を設定すると、既存のキーに対する値が上書きされますが、例外は発生しません。

関連項目

コード サンプル