Partilhar via


Função CONTAINSROW

Aplica-se a: Coluna calculada Tabela calculada Medida Cálculo visual

Retorna TRUE se existir pelo menos uma linha onde todas as colunas tenham valores especificados.

Sintaxe

CONTAINSROW(<Table>, <Value> [, <Value> [, …] ] ) 

Parâmetros

Termo Definição
Tabela Uma tabela para testar.
Value Qualquer expressão DAX válida que retorne um valor escalar.

Valor devolvido

VERDADEIRO ou FALSO.

Observações

  • Exceto a sintaxe, o operador IN e a função CONTAINSROW são funcionalmente equivalentes.

    <scalarExpr> IN <tableExpr> 
    ( <scalarExpr1>, <scalarExpr2>, … ) IN <tableExpr>
    
    • O número de scalarExprN deve corresponder ao número de colunas em tableExpr.
    • NOT IN não é um operador no DAX. Para executar a negação lógica do operador IN, coloque NOT na frente de toda a expressão. Por exemplo, NOT [Color] IN { "Red", "Yellow", "Blue" }.
  • Ao contrário do operador =, o operador IN e a função CONTAINSROW realizam uma comparação estrita. Por exemplo, o valor BLANK não corresponde a 0.

Exemplos

Exemplos neste artigo podem ser usados com o modelo de exemplo do Power BI Desktop do Adventure Works DW 2020. Para obter o modelo, consulte Modelo de exemplo DAX.

Exemplo 1

As seguintes consultas DAX:

EVALUATE
FILTER (
    ALL ( Product[Color] ),
    ( [Color] )
        IN {
        "Red",
        "Yellow",
        "Blue"
    }
)
ORDER BY [Color]

e

EVALUATE
FILTER (
    ALL ( Product[Color] ),
    CONTAINSROW (
        {
            "Red",
            "Yellow",
            "Blue"
        },
        [Color]
    )
)
ORDER BY [Color]

Retornar a tabela a seguir com uma única coluna:

[Cor]
Azul
Vermelho
Yellow

Exemplo 2

As seguintes consultas DAX equivalentes:

EVALUATE
FILTER (
    ALL ( Product[Color] ),
    NOT [Color]
        IN {
        "Red",
        "Yellow",
        "Blue"
    }
)
ORDER BY [Color]

e

EVALUATE
FILTER (
    ALL ( Product[Color] ),
    NOT CONTAINSROW (
        {
            "Red",
            "Yellow",
            "Blue"
        },
        [Color]
    )
)
ORDER BY [Color]

Retornar a tabela a seguir com uma única coluna:

[Cor]
Preto
Cinzento
Vários
ND
Silver
Prata\Preto
Caucasiano

Operador IN
Consultas DAX