Compartir por

Primeiro, funcións FirstN, Index, Last e LastN

  • Artigo

Aplícase a: Aplicacións de lenzo Fluxos de escritorio Aplicacións baseadas en modelos Power Pages Power Platform CLI

Devolve o primeiro, o último ou un rexistro específico, ou un conxunto de primeiros ou últimos rexistros dunha táboa.

Descripción

A función Primeiro devolve o primeiro rexistro dunha táboa.

A función FirstN devolve o primeiro conxunto de rexistros dunha táboa; o segundo argumento especifica o número de rexistros a devolver.

A función Último devolve o último rexistro dunha táboa.

A función LastN devolve o último conxunto de rexistros dunha táboa; o segundo argumento especifica o número de rexistros a devolver.

A función Índice devolve un rexistro dunha táboa en función da súa posición ordenada na táboa. A numeración dos rexistros comeza por 1, polo que First( table ) devolve o mesmo rexistro que Index( table, 1 ). Índice devolve un erro se o índice de rexistros solicitado é menor que 1, maior que o número de rexistros da táboa ou a táboa está baleira.

Primeiro, Índice e Último devolven un único rexistro. PrimeiroN e ÚltimoN devolven unha táboa, aínda que especifique só un rexistro.

Delegación

Estas funcións, cando se usan cunha orixe de datos, non se poden delegar. Só se recuperará a primeira parte da orixe de datos e logo a función aplicada. Pode que o resultado non represente o historial completo. É posible que se mostre un aviso na fase de creación para lembrarlle desta limitación e suxerirlle que mude a alternativas delegables sempre que sexa posible. Para obter máis información, consulte a visión xeral da delegación.

Por exemplo, cando se usa cunha orixe de datos que contén unha táboa grande con 1 millón de rexistros, Último estará suxeito ao límite de non delegación e non devolverá o último rexistro de toda a orixe de datos. Así mesmo, o uso de Índice para solicitar un rexistro no medio de 1 millón de rexistros producirá un erro porque o índice está fóra do intervalo en función do límite de non delegación.

Sintaxe

Primeiro( Táboa )
Último( Táboa )

  • Táboa - Obrigatorio. Táboa na que operar.

PrimeiroN( Táboa [, NumberOfRecords ] )
ÚltimoN( Táboa [, NumberOfRecords ] )

  • Táboa - Obrigatorio. Táboa na que operar.
  • NumberOfRecords - Opcional. Número de rexistros a devolver. Se non especifica este argumento, a función devolverá un rexistro.

Índice( Táboa, Índice de rexistro )

  • Táboa - Obrigatorio. Táboa na que operar.
  • RecordIndex - Obrigatorio. Índice do rexistro que se vai devolver. A numeración dos rexistros comeza por 1.

Exemplos

Para os seguintes exemplos, usaremos a orixe de datos IceCream, que contén os datos desta táboa:

Exemplo de Icecream.

Esta táboa pódese colocar nunha colección con esta fórmula (coloque a fórmula OnStart para un control Button e prema o botón):

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 Descripción Resultado
Primeiro (Xeado) Devolve o primeiro rexistro dun Xeado. { Flavor: "Chocolate", Quantity: 100 }
Último (Xeado) Devolve o último rexistro dun Xeado. { Flavor: "Pistachio", Quantity: 200 }
Índice ( Xeado, 3 ) Devolve o terceiro rexistro dun Xeado. { Flavor: "Strawberry", Quantity: 300 }
PrimeiroN( Xeado, 2) Devolve unha táboa que contén os primeiros dous rexistros do Xeado. Táboa que contén os rexistros de chocolate e vainilla
ÚltimoN( Xeado, 2) Devolve unha táboa que contén os dous últimos rexistros de IceCream. Táboa que contén os rexistros de chocolate con menta e pistacho
Índice( Xeado, 4 ).Cantidade Devolve o cuarto rexistro da táboa e extrae a columna Cantidade. 60
Índice ( Xeados, 10 ) Devolve un erro xa que o rexistro solicitado está máis aló dos límites da táboa. Erro