Pode utilizar as funções DPrimeiro e DÚltimo para devolver um registo aleatório de um campo específico numa tabela ou consulta quando necessitar simplesmente de qualquer valor desse campo. Utilize as funções DPrimeiro e DÚltimo numa macro (macro: acção ou conjunto de acções que podem ser utilizadas para automatizar tarefas. As macros são gravadas na linguagem de programação Visual Basic for Applications.), módulo, expressão de consulta ou controlo calculado (controlo calculado: controlo utilizado num formulário, relatório ou página de acesso a dados para apresentar o resultado de uma expressão. O resultado é calculado de novo sempre que houver uma alteração em qualquer dos valores nos quais a expressão se baseia.) num formulário ou relatório.
Sintaxe
DPrimeiro(expr, domínio [, critérios] )
DÚltimo(expr, domínio [, critérios] )
As funções DPrimeiro e DÚltimo têm os seguintes argumentos:
| Argumento |
Descrição |
| expr |
Obrigatório. Uma expressão que identifica o campo em que pretende encontrar o primeiro e o último valor. Pode ser uma expressão da cadeia (expressão de cadeia: expressão que equivale a uma sequência de caracteres contíguos. Os elementos da expressão podem ser: funções que devolvem uma cadeia ou uma Variante de cadeia (VarType 8); uma cadeia literal, uma constante, uma variável ou Variante.) que identifique um campo numa tabela ou consulta ou uma expressão que efectue um cálculo dos dados nesse campo. No argumento expr, pode incluir o nome de um campo numa tabela, um controlo num formulário, uma constante ou uma função. Se o argumento expr incluir uma função, esta pode ser incorporada ou definida pelo utilizador, mas não outra função de domínio agregado ou de agregação SQL. |
| domínio |
Obrigatório. Uma expressão da cadeia que identifica o conjunto de registos que constituem o domínio. |
| critérios |
Opcional. Uma expressão da cadeia utilizada para restringir o intervalo de dados em que a função DPrimeiro ou DÚltimo é executada. Por exemplo, o argumento critérios é frequentemente equivalente à cláusula WHERE numa expressão SQL, sem a palavra WHERE. Se omitir o argumento critérios, as funções DPrimeiro e DÚltimo avaliam o argumento expr em relação a todo o domínio. Qualquer campo incluído em critérios também tem de ser um campo em domínio; caso contrário, as funções DPrimeiro e DÚltimo devolvem um valor Nulo (Null: valor que pode introduzir num campo ou utilizar em expressões ou consultas para indicar dados em falta ou desconhecidos. No Visual Basic, a palavra-chave Null indica um valor nulo (Null). Alguns campos, como campos de chave primária, não podem conter Null.). |
Observações
Nota Se pretender devolver o primeiro ou o último registo num conjunto de registos (um domínio (domínio: conjunto de registos definido por uma tabela, consulta ou expressão SQL. As funções de agregação de domínio devolvem informações estatísticas sobre um domínio específico ou um conjunto de registos.)), deve criar uma consulta por ordem ascendente ou descendente e definir a propriedade TopValues como 1. Para mais informações, consulte o tópico da propriedade TopValues. Num módulo do Visual Basic for Applications (VBA), também pode criar um objecto Conjunto de Registos do ADO e utilizar o método MoverPrimeiro ou MoverÚltimo para devolver o primeiro ou o último registo num conjunto de registos.