Função Switch

Observação: Desejamos fornecer o conteúdo da Ajuda mais recente no seu idioma da forma mais rápida possível. Esta página foi traduzida de forma automatizada e pode conter imprecisões ou erros gramaticais. Nosso objetivo é que este conteúdo seja útil para você. As informações foram úteis? Dê sua opinião no final desta página. Aqui está o artigo em inglês para facilitar a referência.

Avalia uma lista de expressões e retorna um valor ou uma expressão Variante associada com a primeira expressão da lista que é Verdadeiro.

Sintaxe

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

A sintaxe da função Switch possui os seguintes argumentos:

Argumento

Descrição

expr

Necessário. Expressão variante que você deseja avaliar.

valor

Necessário. Valor ou expressão a ser retornada se a expressão correspondente for verdadeiro.


Comentários

Lista de argumento de função Switch 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 avaliada como True será retornado. Se as partes não tiverem pares adequados, ocorrerá um erro em tempo de execução. Por exemplo, se expr-1 for verdadeiro, o Switch retornará o valor-1. Se expr-1 for Falso, mas expr-2 for verdadeiro, Switch retorna o valor-2e assim por diante.

Alternar retorna um valor nulo se:

  • Nenhuma das expressões for verdadeiro.

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

Alternar avalia todas as expressões, mesmo que ela retorne apenas uma delas. Por esse motivo, você deve ficar atento à lado indesejada. Por exemplo, se a avaliação de qualquer expressão resulta em uma divisão por zero, ocorrerá um erro.

Exemplo

Observação: Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa e insira um ou mais termos na caixa de pesquisa.

Este exemplo usa a função Switch para retornar o nome de um idioma que corresponda ao nome de uma cidade.

Function MatchUp (CityName As String)
Matchup = Switch(CityName = "London", "English", _
CityName = "Rome", "Italian", _
CityName = "Paris", "French")
End Function
Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×