이름 지정된 필드의 값 목록에 지정된 값을 추가합니다.
이 메소드는 하나의 값을 제공하는 대신 값 목록에 항목을 추가한다는 점을 제외하면 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);