Função parâmetro

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

Parâmetro ( 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 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 de argumento 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 ser avaliado como verdadeiro é devolvido. Se as partes não estiverem corretamente emparelhadas, ocorre uma erro em tempo de execução. Por exemplo, se expr-1 for verdadeiro, parâmetro devolve o valor-1. Se expr-1 for falso, mas expr-2 for verdadeiro, parâmetro devolve o valor-2e assim sucessivamente.

Opção devolve um valor nulo se:

  • Nenhuma das expressões é verdadeiro.

  • A primeira expressão verdadeiro tem um valor correspondente nulo.

A opção avalia todas as expressões, mesmo que devolva apenas uma delas. Por este motivo, deve ver efeitos colaterais indesejados. 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

Selecione ProductSales. ProductID, switch ([CódigoDoProduto] = "PRO_XYZ1"; "primeiro", [CódigoDoProduto] = "PRO_XYZ2", "dois"; [CódigoDoProduto] = "PRO_XYZ1", "dez") como testSwitch de ProductSales;

Devolve o "CódigoDoProduto", avalia as expressões na fórmula "mudar" e alterna os valores existentes com valores definidos para todas as expressões "verdadeiro". Por exemplo: "PRO_XYZ1" é substituído por "First", "PRO_XYZ2" é substituído por "Two" 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 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

Nota:  Esta página foi traduzida automaticamente e pode conter erros gramaticais ou imprecisões. O nosso objetivo é que estes conteúdos lhe sejam úteis. Pode indicar-nos se estas informações foram úteis? Eis o artigo em inglês para sua referência.​

Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×