Saltar para o conteúdo principal
Versão: 20 R10

QUERY WITH ARRAY

QUERY WITH ARRAY* ( campoAlvo ; array )

ParâmetroTipoDescrição
campoAlvoFieldCampo usado para comparar os valores
arrayArrayArray de valores pesquisados

Descrição

comando QUERY WITH ARRAY busca na tabela do campo passado no primeiro parâmetro todos os registros para os quais o valor de campoAlvo, for igual ao menos a um dos valores dos elementos em Array. Os registros encontrados constituem a nova seleção atual.

Este comando lhe permite construir rápida e simplesmente uma pesquisa em múltiplos valores.

Notas:

• Este comando não pode ser utilizado com campos de tipo Imagem, subcampo e BLOB.
campoAlvo e Array devem ser do mesmo tipo. Exceção: pode utilizar um array de tipo Inteiro longo com um campo de tipo Hora.

Exemplo

O exemplo a seguir lhe permite recuperar os registros de clientes franceses e americanos:

 ARRAY TEXT(ArrayPesquisa;2)
 ArrayPesquisa{1}:="FR"
 ArrayPesquisa{2}:="US"
 QUERY WITH ARRAY([Clientes]Países;ArrayPesquisa)

Ver também

QUERY SELECTION WITH ARRAY

Propriedades

Número do comando644
Thread-seguro
Modificar a seleção atual