entitySelection.add()

Home

4D v19.8


entitySelection.add() ( entity ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
entity	Entity	Entity zum Hinzufügen in der Entity-Selection
Funktionsergebnis	EntitySelection	Entity selection including the added entity

Beschreibung

Die Methode entitySelection.add() fügt die angegebene Entity in der Entity-Selection hinzu und gibt die geänderte Entity-Selection zurück.

Hinweis: Diese Methode ändert die ursprüngliche Entity-Selection.

Warnung: Die Entity-Selection muss non shareable sein: z.B. erstellt mit dataClass.newSelection() oder Create entity selection, sonst gibt entitySelection.add() einen Fehler zurück. Bei shareable Entity-Selections lassen sich keine neuen Entities hinzufügen. Weitere Informationen dazu finden Sie im Abschnitt Shareable vs alterable Entity-Selections.

Bei sortierter Entity-Selection wird entity am Ende der Selection hinzugefügt. Gehört eine Referenz derselben Entity bereits zur Entity-Selection, wird sie dupliziert und eine neue Referenz hinzugefügt.
Bei unsortierter Entity-Selection wird entity irgendwo in der Selection hinzugefügt.

Die Funktion gibt die geänderte Entity-Selection zurück, so dass sich die Aufrufe der Funktion verketten lassen.

Sind entity und die Entity-Selection nicht mit derselben Dataclass verknüpft, tritt ein Fehler auf. Ist die Entity zum Hinzufügen Null, gibt es keinen Fehler.

Beispiel 1

 var $employee : cs.EmployeeEntity

 var $employees : cs.EmployeeSelection

 

 $employees:=ds.Employee.query("lastName = :1";"S@") //gemeinsam nutzbare Entity-Selection

 

 $employee:=ds.Employee.new()

 $employee.lastName:="Smith"

 $employee.save()

 

 $employees:=$employees.copy() //Nicht gemeinsam nutzbare Version der Entity-Selection erhalten

 $employees.add($employee) //Die Entity $employee der Entity-Selection $employees hinzufügen

Beispiel 2

Die Aufrufe der Funktion lassen sich verketten:

 var $sel : cs.ProductSelection

 var $p1;$p2;$p3 : cs.ProductEntity

 $p1:=ds.Product.get(10)

 $p2:=ds.Product.get(11)

 $p3:=ds.Product.get(12)

 $sel:=ds.Product.query("ID > 50")

 $sel:=$sel.add($p1).add($p2).add($p3)

Siehe auch

entitySelection.and( )
entitySelection.drop()
entitySelection.minus()