DeleteFieldValue

Description

Removes the specified value from the field's list of values.

This method is intended only for those fields that can support a list of values. However, it is legal to use this method for a field that takes a single value. (In that case, the field's only value must be the same as old_value; the method then sets the field's value to the empty value.)

Vous pouvez uniquement appeler cette méthode si l'objet Entity est éditable. Pour rendre un objet Entity existant éditable, appelez la méthode EditEntity de l'objet Session.

Syntaxe

VBScript

entity.DeleteFieldValue field_name, old_value 

Perl

$entity->DeleteFieldValue(field_name, value); 
Identificateur
Description
entity
Objet Entity représentant un enregistrement de données utilisateur. Si vous omettez cette partie de la syntaxe au sein d'un point d'ancrage, l'objet Entity correspondant à l'enregistrement de données en cours est faux (VBScript uniquement).
nom_zone
A String containing a valid field name of this Entity object.
old_value
A Variant containing the value to remove from the field's list of values.
value
A string containing the value to remove from the field's list of values.
Valeur renvoyée
S'il est possible de modifier la zone, cette méthode renvoie une chaîne vide ; sinon, elle renvoie une chaîne contenant une explication de l'erreur.

Exemples

VBScript

AddFieldValue "field1", "option 1" 
AddFieldValue "field1", "option 2" 
AddFieldValue "field1", "option 3" 
DeleteFieldValue "field1", "option 2" 
DeleteFieldValue "field1", "option 3" 

Perl

$entity->AddFieldValue("field1", "option 1");

$entity->AddFieldValue("field1", "option 2");

$entity->AddFieldValue("field1", "option 3");



$entity->DeleteFieldValue("field1", "option 2");

$entity->DeleteFieldValue("field1", "option 3"); 

Feedback