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, valor-1 [, expr-2, valor-2 ] ... [, expr-n, valor-n ] )
A sintaxe da função Parâmetro tem os seguintes argumentos:
| Argumento | Descrição |
|---|---|
| expr | Obrigatório. Expressão variante que pretende avaliar. |
| valor | Obrigatório. Valor ou expressão a ser devolvida se a expressão correspondente for Verdadeiro. |
Observações
A lista de argumentos da função Parâmetro consiste em pares de expressões e valores. As expressões são avaliadas da esquerda para a direita e o valor associado à primeira expressão a avaliar como Verdadeiro é devolvido. Se as peças não estiverem corretamente emparelhadas, ocorre um erro em tempo de execução. Por exemplo, se expr-1 for Verdadeiro, Parâmetro devolve valor-1. Se expr-1 for Falso, mas expr-2 for True, Switch retornará valor-2 e assim por diante.
O parâmetro devolve um valor Nulo se:
- Nenhuma das expressões é Verdadeira.
- A primeira expressão True tem um valor correspondente que é Null.
O parâmetro avalia todas as expressões, apesar de devolver apenas uma delas. Por esta razão, deve ter em atenção os efeitos secundários indesejáveis. Por exemplo, se a avaliação de qualquer expressão resultar num erro de divisão por zero, ocorre 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 "IDDoProduto", avalia as expressões na fórmula "Parâmetro" e altera 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 do 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 Parâmetro 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