Adds the specified value to the list of values in the named field.
This method is similar to SetFieldValue, except that it adds an item to a list of values, instead of providing the sole value. This method is intended for fields that can accept a list of values. If a field does not already contain a value, you can still use this method to set the value of a field that takes a single value. No validation takes place during the call to AddFieldValue.
The AddFieldValue method is designed to work with list fields. It is not designed to work with scalar fields (such as string, multiline string, and reference).
No validation takes place during a call to the AddFieldValue method. To determine whether a field contains a valid value, obtain the Objet FieldInfo for that field and call ValidityChangedThisSetValue of the FieldInfo object to validate the field.
Vous pouvez uniquement appeler cette méthode si l'objet Entity est éditable. To make an existing Entity object editable, call EditEntity of the Session object.
VBScript
entity.AddFieldValue field_name, new_value
Perl
$entity->AddFieldValue(field_name, new_value);