Funções Count, CountA, CountIf e CountRows no PowerAppsCount, CountA, CountIf, and CountRows functions in PowerApps

Contabiliza todos os registos numa tabela ou todos os registos que satisfazem uma condição.Counts all records in a table, or counts all records that satisfy a condition.

DescriçãoDescription

A função Count contabiliza o número de registos que contêm um número numa tabela de coluna única.The Count function counts the number of records that contain a number in a single-column table.

A função CountA contabiliza o número de registos que não estão em branco numa tabela de coluna única.The CountA function counts the number of records that aren't blank in a single-column table. Esta função inclui texto vazio ("") na contagem.This function includes empty text ("") in the count.

A função CountIf contabiliza o número de registos numa tabela com o valor verdadeiro para uma fórmula lógica.The CountIf function counts the number of records in a table that are true for a logical formula. A fórmula pode fazer referência a colunas da tabela.The formula can reference columns of the table.

A função CountRows contabiliza o número de registos numa tabela.The CountRows function counts the number records in a table.

Cada uma destas funções devolve um número.Each of these functions returns a number.

Quando é utilizada com origem de dados, estas funções não podem ser delegadas.When used with a data source, these functions can't be delegated. Só será obtida a primeira porção da origem de dados e, depois, a função aplicada.Only the first portion of the data source will be retrieved and then the function applied. O resultado poderá não representar a totalidade.The result may not represent the complete story. Quando chegar a hora de criação, será apresentado um ponto azul para o lembrar desta limitação, assim como uma sugestão para mudar para alternativas delegáveis sempre que possível.A blue dot will appear at authoring time to remind you of this limitation and to suggest switching to delegable alternatives where possible. Para obter mais informações, veja a descrição geral da delegação.For more information, see the delegation overview.

SintaxeSyntax

Count( SingleColumnTable )Count( SingleColumnTable )
CountA( SingleColumnTable )CountA( SingleColumnTable )

  • SingleColumnTable - Necessário.SingleColumnTable - Required. Coluna de registos a contabilizar.Column of records to count.

CountIf( Tabela, LogicalFormula )CountIf( Table, LogicalFormula )

  • Tabela - Necessário.Table - Required. Tabela de registos a contabilizar.Table of records to count.
  • LogicalFormula – Necessário.LogicalFormula - Required. Fórmula a avaliar para cada registo da tabela.Formula to evaluate for each record of the table. Os registos que devolvem o valor verdadeiro para esta fórmula são contabilizados.Records that return true for this formula are counted. A fórmula pode fazer referência a colunas da tabela.The formula can reference columns of the table.

CountRows( Tabela )CountRows( Table )

  • Tabela - Necessário.Table - Required. Tabela de registos a contabilizar.Table of records to count.

ExemploExample

  1. Importe ou crie uma coleção denominada Inventário, tal como descrito no primeiro subprocedimento em Mostrar imagens e texto numa galeria.Import or create a collection named Inventory, as the first subprocedure in Show images and text in a gallery describes.
  2. Adicione uma etiqueta e defina a propriedade Texto para esta fórmula:Add a label, and set its Text property to this formula:

    CountIf(Inventory, UnitsInStock < 30)CountIf(Inventory, UnitsInStock < 30)

    A etiqueta mostra o valor 2, porque dois produtos (Ganymede e Callisto) possuem menos de 30 unidades em stock.The label shows 2 because two products (Ganymede and Callisto) have fewer than 30 units in stock.

  3. Adicione outra etiqueta e defina a propriedade Texto para esta fórmula:Add another label, and set its Text property to this formula:

    CountA(Inventory.UnitsInStock)CountA(Inventory.UnitsInStock)

    A etiqueta mostra o valor 5, o número de células não vazias na coluna UnitsInStock.The label shows 5, the number of non-empty cells in the UnitsInStock column.

  4. Adicione outra etiqueta e defina a propriedade Text para esta fórmula:Add another label, and set its Text property to this formula:

    CountRows(Inventory)CountRows(Inventory)

    A etiqueta mostra o valor 5, porque a coleção contém cinco linhas.The label shows 5 because the collection contains five rows.