フィールドが変更可能な場合、新規の値が有効であるかどうかに関係なく、このメソッドによって新規の値が設定され、空の文字列が戻されます。フィールドに有効な値が入っているかどうかを判別するには、そのフィールドの FieldInfo オブジェクトを取り出し、FieldInfo オブジェクトの ValidityChangedThisSetValue メソッドを呼び出して、フィールドを検証します。
フィールドを変更できない場合、戻された文字列に、フィールドを変更できない理由が示されています。通常の値は、「no such field」、「record is not being edited」、「field is read-only」です。
フィールドが 1 つでなく複数の値を持つことができる場合は、AddFieldValue メソッドを使用してそれぞれの新規の値を追加します。SetFieldValue を使用することも正しい方法です。しかし、既に値のリストが含まれているフィールドに SetFieldValue を使用すると、リスト全体が新規の単一値で置換されます。
このメソッドは、Entity オブジェクトが編集可能な場合にのみ呼び出すことができます。既存の Entity オブジェクトを編集可能にするには、Session オブジェクトの EditEntity メソッドを呼び出します。
VBScript
entity.SetFieldValue field_name, new_value
Perl
$entity->SetFieldValue(field_name, new_value);
VBScript
' Set two field values, but only check errors for ' the second field. entity.SetFieldValue "field1", "new value" returnVal = SetFieldValue("field2", "100")
Perl
# Set two field values for the entity # Perform error checking on the second field $entity->SetFieldValue("field1","new value"); $returnval = $entity->SetFieldValue("field2","100");