entitySelection[index]

Home

4D v19.8


entitySelection[index] -> Funktionsergebnis

Parameter	Typ	Beschreibung
Funktionsergebnis	Entity	Entity zum angegebenen Index

Beschreibung

Über die Notation entitySelection[index] können Sie in der Entity-Selection über die Standardsyntax für Collection auf Entities zugreifen. Dazu übergeben Sie im Parameter index die Position der gewünschten Entity.

Beachten Sie, dass die entsprechende Entity vom Datastore geladen wird.

index kann jede Nummer zwischen 0 und entitySelection.length-1 sein.

Ist index außerhalb des Bereichs, wird ein Fehler zurückgegeben.
Entspricht index einer gelöschten Entity, wird Null zurückgegeben.

entitySelection[index] ist ein nicht-zuweisbarer Ausdruck, d.h. er lässt sich nicht als editierbare Entity Referenz mit Methoden wie entity.lock() oder entity.save( ) verwenden. Um mit der entsprechenden Entity zu arbeiten, müssen Sie den zurückgegebenen Ausdruck einem zuweisbaren Ausdruck zuordnen, z.B. eine Variable. Beispiele:

 $sel:=ds.Employee.all() //Die Entity-Selection erstellen

  //ungültige Anweisungen:

 $result:=$sel[0].lock() //funktioniert NICHT

 $sel[0].lastName:="Smith" //funktioniert NICHT

 $result:=$sel[0].save() //funktioniert NICHT

  //gültiger Code:

 $entity:=$sel[0]  //OK

 $entity.lastName:="Smith" //OK

 $entity.save() //OK

Beispiel

 C_OBJECT($employees;$employee)

 $employees:=ds.Employee.query("lastName = :1";"H@")

 $employee:=$employees[2]  // Die 3. Entity der Entity-Selection $employees wird von der Datenbank geladen

Siehe auch

entity.reload()
entitySelection.first()