PivotFilter.Order Propriedade

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Especifica a ordem de avaliação do filtro entre todos os filtros de valor aplicados a todo PivotTableo . Leitura/gravação

public:
 property int Order { int get(); void set(int value); };

public int Order { get; set; }

Public Property Order As Integer

Valor da propriedade

Int32

Número inteiro.

Comentários

Essa propriedade é válida apenas para os tipos PivotFilterValue e Topn. Um erro de tempo de execução é retornado se uma tentativa for feita para definir ou obter essa propriedade para filtros Rótulo e Data . 1 representa o primeiro filtro avaliado, 2 representa o próximo filtro avaliado e assim por diante, até que o nvalor de th seja atingido. -1 representa um filtro inativo.

Se a Order propriedade não for especificada quando um novo filtro for adicionado, ela será definida como N+1 (onde N é o número mais Order alto atual na coleção de filtros).

A propriedade pode ser especificada no Microsoft.Office.Interop.Excel.PivotFilters.Add método ou pode ser definida posteriormente para um campo alterando a propriedade.

O aumento da ordem de avaliação de um campo diminuirá a ordem de avaliação do campo que mantém o valor dessa ordem de avaliação—e todos os campos entre os dois campos—por um. A definição da ordem de avaliação com o mesmo valor de antes não terá efeito. A diminuição da ordem de avaliação de um campo aumentará a ordem de avaliação do campo que mantinha o valor dessa ordem de avaliação—e todos os campos entre os dois campos—por um.

A ordem da PivotFilters na coleção é a mesma da ordem em que elas são avaliadas. Portanto, os desenvolvedores podem alterar a ordem na qual um PivotField é avaliado. Quando um PivotField (não OLAP PivotTables) ou um CubeField (OLAP PivotTables) é removido da PivotTables coleção, essa propriedade é definida como -1 para um valor ou um filtro Top n aplicado ao campo. Adicionar o campo novamente definirá a Order propriedade como N+1 para um filtro Value ou Top n aplicado se um valor não for especificado explicitamente.