Compartilhar via


Método WorksheetFunction.Aggregate (Excel)

Retorna um valor agregado em uma lista ou banco de dados.

Sintaxe

expressão. Agregar (Arg1, Arg2, Arg3, Arg4, Arg5, Arg6, Arg7, Arg8, Arg9, Arg10, Arg11, Arg12, Arg13, Arg14, Arg15, Arg16, Arg17, Arg18, Arg19, Arg20, Arg21, Arg22, Arg23, Arg24, Arg25, Arg26, Arg27, Arg28, Arg29, Arg30)

expressão Uma variável que representa um objeto WorksheetFunction .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Arg1 Obrigatório Double Núm_função - um número de 1 a 19 que especifica qual função usar.
Function_num Function
1MÉDIA
2COUNT
3COUNTA
4MÁXIMO
5MÍNIMO
6PRODUTO
7DESVPAD. S
8DESVPAD. P
9SOMA
10VAR. S
11VAR. P
12MEDIANA
13MODO. SNGL
14GRANDE
15PEQUENO
16PERCENTIL. INC
17QUARTIL. INC
18PERCENTIL. EXC
19QUARTIL. EXC
Arg2 Obrigatório Double Opção – um valor numérico que determina os valores a ignorar no intervalo de avaliação da função.
Opção Comportamento
0 ou omitidoIgnorar funções aninhadas de SUBTOTAL e AGGREGATE
1Ignorar linhas ocultas, funções aninhadas de SUBTOTAL e AGGREGATE
2Ignorar valores de erro, funções aninhadas de SUBTOTAL e AGGREGATE
3Ignorar linhas ocultas, valores de erro, funções aninhadas de SUBTOTAL e AGGREGATE
4Ignorar nada
5Ignorar linhas ocultas
6Ignorar valores de erro
7Ignorar linhas ocultas e valores de erro
Arg3 Obrigatório Range Ref1 – o primeiro argumento numérico para funções que assumem vários argumentos numéricos para os quais pretende obter o valor agregado.
Arg4 - Arg 30 Opcional Variant Ref2 - Ref30 - Argumentos numéricos de 2 a 30 para os quais pretende obter o valor agregado.

Valor de retorno

Double

Comentários

As seguintes restrições aplicam-se aos argumentos Ref (Arg3 – Arg 30) com base no valor Function_num .

Function_num Ref1 Ref2 Ref3, Ref4, ?
1-13 Tipos válidos:
  • Qualquer referência de célula

  • Sindicatos

  • Intersecções

  • Nomes definidos

  • Referências estruturadas

Tipos inválidos:
  • Dados reais

  • Matrizes

Tipos válidos:
  • Qualquer referência de célula

  • Sindicatos

  • Intersecções

  • Nomes definidos

  • Referências estruturadas

Tipos inválidos:
  • Dados reais

  • Matrizes

Tipos válidos:
  • Qualquer referência de célula

  • Sindicatos

  • Intersecções

  • Nomes definidos

  • Referências estruturadas

Tipos inválidos:
  • Dados reais

  • Matrizes

14-17 Tipos válidos:
  • Qualquer referência de célula

  • Sindicatos

  • Intersecções

  • Nomes definidos

  • Referências estruturadas

  • Dados reais

  • Matrizes

Tipos válidos:
  • Qualquer referência de célula

  • Sindicatos

  • Intersecções

  • Nomes definidos

  • Referências estruturadas

  • Dados reais

  • Matrizes

Não são permitidas referências

Se for necessário um segundo argumento ref, mas não for fornecido, Agregar devolve um #VALUE! .

Se uma ou mais das referências forem referências 3D, Agregação devolve o #VALUE! valor de erro.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.