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 FieldInfo Object for that field and call ValidityChangedThisSetValue of the FieldInfo object to validate the field.
You can call this method only if the Entity object is editable. 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);