설명
이름 지정된 필드의 값 목록에 지정된 값을 추가합니다.
이 메소드는 하나의 값을 제공하는 대신 값 목록에 항목을 추가한다는 점을 제외하면
SetFieldValue와 유사합니다.
이 메소드는 값 목록을 승인할 수 있는 필드에 사용하도록 설계되었습니다.
필드에 이미 값이 포함되어 있지 않으면, 계속해서 이 메소드를 사용하여 단일 값을 취하는 필드의 값을 설정할 수 있습니다.
주: AddFieldValue 메소드는 목록 필드에서 작동하도록 설계되었습니다.
스칼라 필드(예: 문자열, 다중 행 문자열 및 참조)에서는 작동하지 않도록 설계되었습니다.
필드가 올바른 값을 포함하는지 판별하려면
해당 필드에 대한 FieldInfo 오브젝트를 확보한 후
FieldInfo 오브젝트의 ValidityChangedThisSetValue를
호출하여 필드의 유효성을 검증하십시오.
Entity 오브젝트가 편집 가능한 경우에만
이 메소드를 호출할 수 있습니다.
기존의 Entity 오브젝트를 편집 가능하게 만들려면 Session 오브젝트의
EditEntity 메소드를 호출하십시오.
구문
VBScript
entity.AddFieldValue field_name, new_value
Perl
$entity->AddFieldValue(field_name, new_value);
- ID
- 설명
- entity
- 사용자 데이터 레코드를 나타내는 Entity 오브젝트.
후크 내에서 구문에 이 부분을 생략할 경우, Entity 오브젝트가 현재 데이터 레코드에
해당한다고 가정합니다.
- field_name
- Entity 오브젝트의 올바른 필드 이름을 포함하는 문자열.
- new_value
- Visual Basic의 경우, 필드에 추가할 새 값을 포함하는 Variant 값. Perl의 경우, 새 값을 포함하는 문자열.
- Return value
- 필드 변경이 허용될 경우 이 메소드는 빈 문자열을 리턴합니다.
허용되지 않으면 오류에 대한 설명이 들어 있는 문자열을 리턴합니다.
예제
VBScript
AddFieldValue "field1", "option 1"
AddFieldValue "field1", "option 2"
AddFieldValue "field1", "option 3"
Perl $entity->AddFieldValue("field1", "option 1");
$entity->AddFieldValue("field1", "option 2"); $entity->AddFieldValue("field1",
"option 3");