Funções First, FirstN, Index, Last e LastN
Aplica-se a: Aplicativos de tela Fluxos da área de trabalho Aplicativos baseados em modelo Power Pages Power Platform CLI
Retorna o primeiro, o último ou um registro específico, ou um conjunto de primeiros ou últimos registros de uma tabela.
Descrição
A função First retorna o primeiro registro de uma tabela.
A função FirstN retorna o primeiro conjunto de registros de uma tabela; o segundo argumento especifica o número de registros a serem retornados.
A função Last retorna o último registro de uma tabela.
A função LastN retorna o último conjunto de registros de uma tabela; o segundo argumento especifica o número de registros a serem retornados.
A função Index retorna um registro de uma tabela com base em sua posição ordenada na tabela. A numeração do registro começa com 1, então First( table )
retorna o mesmo registro do que Index( table, 1 )
.
Index retornará um erro se o índice de registro solicitado for menor do que 1, maior do que o número de registros na tabela ou se a tabela estiver vazia.
First, Index, and Last retornam um único registro. FirstN e LastN retornarão uma tabela, mesmo se você especificar um único registro.
Delegação
Quando usadas com uma fonte de dados, estas funções não poderão ser delegadas. Somente a primeira parte da fonte de dados será recuperada e então a função será aplicada. O resultado pode não representar a história completa. Um aviso pode ser exibido no momento da criação para lembrá-lo dessa limitação e para sugerir a troca para alternativas delegáveis sempre que possível. Para obter mais informações, consulte visão geral de delegação.
Por exemplo, quando usado com um fonte de dados contendo uma tabela grande com 1 milhão de registros, Last estará sujeito ao limite de não delegação e não retornará o último registro de todo o fonte de dados. Da mesma forma, o uso de Index para solicitar um registro no meio de 1 milhão de registros resultará em um erro porque o índice está fora do intervalo com base no limite de não delegação.
Sintaxe
First( Table )
Last( Table )
- Table - obrigatório. Tabela na qual operar.
FirstN( Table [, NumberOfRecords ] )
LastN( Table [, NumberOfRecords ] )
- Table - obrigatório. Tabela na qual operar.
- NumberOfRecords - opcional. Número de registros a serem retornados. Se você não especificar esse argumento, a função retornará um registro.
Index( Table, RecordIndex )
- Table - obrigatório. Tabela na qual operar.
- RecordIndex - obrigatório. O índice do registro a ser retornado. A numeração dos registros começa com 1.
Exemplos
Para os exemplos a seguir, usaremos a fonte de dadosIceCream, que contém os dados nesta tabela:
Esta tabela pode ser colocada em uma coleção com esta fórmula (coloque a fórmula OnStart para um controle Button e pressione o botão):
Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
{ Flavor: "Vanilla", Quantity: 200 },
{ Flavor: "Strawberry", Quantity: 300 },
{ Flavor: "Mint Chocolate", Quantity: 60 },
{ Flavor: "Pistachio", Quantity: 200 } ) )
Fórmula | Descrição | Resultado |
---|---|---|
First( IceCream ) | Retorna o primeiro registro de IceCream. | { Flavor: "Chocolate", Quantity: 100 } |
Last( IceCream ) | Retorna o último registro de IceCream. | { Flavor: "Pistachio", Quantity: 200 } |
Index( IceCream, 3 ) | Retorna o terceiro registro de IceCream. | { Flavor: "Strawberry", Quantity: 300 } |
FirstN( IceCream, 2 ) | Retorna uma tabela com os dois primeiros registros de IceCream. | |
LastN( IceCream, 2 ) | Retorna uma tabela com os dois últimos registros de IceCream. | |
Index( IceCream, 4 ).Quantity | Retorna o quarto registro da tabela e extrai a coluna Quantidade. | 60 |
Index( IceCream, 10 ) | Retorna um erro, pois o registro solicitado está além dos limites da tabela. | Erro |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de