指定された値を、指定されたフィールドの値のリストに追加します。
このメソッドは SetFieldValue と似ています。ただし、単独の値を指定する代わりに、アイテムを値のリストに追加するのを除きます。このメソッドは、値のリストを受け入れ可能なフィールドを意図しています。 フィールドにまだ値が格納されていない場合、このメソッドをそのまま使用して単一値を使用するフィールドの値を設定できます。AddFieldValue への呼び出し中に確認は行われません。
AddFieldValue メソッドは、リスト フィールドを操作することを意図しています。 スカラ フィールド (文字列、複数行文字列、参照など) を操作することは意図していません。
AddFieldValue メソッドへの呼び出し中に確認は行われません。フィールドに有効な値が格納されているかどうか判別するには、そのフィールドの FieldInfo オブジェクトを取得し、FieldInfo オブジェクトの ValidityChangedThisSetValue を呼び出して、フィールドを検証します。
このメソッドは、Entity オブジェクトが編集可能な場合にのみ呼び出すことができます。既存の Entity オブジェクトを編集可能にするには、Session オブジェクトの EditEntity を呼び出します。
VBScript
entity.AddFieldValue field_name,new_value
Perl
$entity->AddFieldValue(field_name, new_value);