Applies ToAccess para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Avalia uma lista de expressões e devolve um valor de Variante ou uma expressão associada à primeira expressão da lista que é Verdadeira.

Sintaxe

Switch( expr-1, value-1 [, expr-2, value-2 ] ... [, expr-n, value-n ] )

A sintaxe da função Switch tem estes argumentos:

Argumento

Descrição

expr

Obrigatório. Expressão de variante que pretende avaliar.

valor

Obrigatório. Valor ou expressão a devolver se a expressão correspondente for Verdadeiro.

Observações

A lista argumento função Switch consiste em pares de expressões e valores. As expressões são avaliadas da esquerda para a direita e é devolvido o valor associado à primeira expressão a avaliar como Verdadeiro . Se as partes não estiverem corretamente emparelhadas, ocorrerá um erro em tempo de execução. Por exemplo, se expr-1 for Verdadeiro, Switch devolve value-1. Se expr-1 for Falso, mas expr-2 for Verdadeiro, Switch devolve o valor-2 e assim sucessivamente.

O parâmetro devolve um valor Nulo se:

  • Nenhuma das expressões é Verdadeira.

  • A primeira expressão True tem um valor correspondente que é Nulo.

O Parâmetro avalia todas as expressões, apesar de devolver apenas uma delas. Por este motivo, deve watch para efeitos colaterais indesejáveis. Por exemplo, se a avaliação de qualquer expressão resultar num erro de divisão por zero, ocorrerá um erro.

Exemplo de consulta

Expressão

Resultados

SELECT ProductSales.ProductID, Switch([ProductID]="PRO_XYZ1","First",[ProductID]="PRO_XYZ2","Two",[ProductID]="PRO_XYZ1","Ten") AS testSwitch FROM ProductSales;

Devolve o "ProductID", avalia as expressões na fórmula "Mudar" e muda os valores existentes com valores definidos para todas as expressões "Verdadeiro". Por exemplo: "PRO_XYZ1" é substituído por "Primeiro", "PRO_XYZ2" é substituído por "Dois" e assim sucessivamente.

Exemplo de VBA

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza a função Switch para devolver o nome de um idioma que corresponde ao nome de uma cidade.

Function MatchUp (CityName As String)    Matchup = Switch(CityName = "London", "English", _              CityName = "Rome", "Italian", _              CityName = "Paris", "French")End Function

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.