Criar seleção de entidade

4D v19.8


Criar seleção de entidade ( dsTable {; settings} ) -> Resultado

Parâmetro	Tipo	Descrição
dsTable	Tabela	Tabela no banco de dados 4D cuja seleção atual será usada para construir a entidade
settings	Objeto	Opção de construção: contexto
Resultado	EntitySelection	Seleção de entidade combinando a classe de dados relacionada a tabela dada

Descrição

O comando Criar seleção de entidade cria e devolve uma nova seleção de entidade relacionada com a classe de dados que coincide com dsTable, de acordo com a seleção atual desta tabela.

Nota: Para saber mais, ver Seleção de Entidade Compatível vs Não-compatível.

Se a seleção atual for ordenada, uma seleção de entidade ordenada é criada (é guardada a ordem da seleção atual). Se a seleção atual não for ordenada, uma seleção de entidade não ordenada é criada.Para saber mais, consulte o parágrafo Entity selections Ordenadas vs não ordenadas na Guía do desenvolvedor 4D.

Se a dsTable não estiver exposta em ds, um erro é devolvido.
Este comando não pode ser utilizado com um Datastore remota.

settings

No parâmetro opcional settings, você pode passar um objeto contendo opções adicionais. A seguinte propriedade é suportada:

Propriedade	Tipo	Descrição
context	Texto	Rótulo para o contexto de otimização aplicado à seleção de entidade. Esse contexto será usado pelo código que manipula a seleção de entidade para que possa se beneficiar da otimização. Esse recurso é projetado para processamento de cliente / servidor ORDA; Para mais informações, consulte a seção Client/server optimization.

Exemplo

 C_OBJECT($employees)

 ALL RECORDS([Employee])

 $employees:=Criar seleção de entidade([Employee])

  //A seleção da entidade $employees agora contém um conjunto de referências sobre todas as entidades relacionadas com a classe de dados Employee

Ver também

USE ENTITY SELECTION