Função Choose

Aplica-se a
Access para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Retorna um valor de uma lista de argumentos.

Sintaxe

Choose(index, choice-1 [, choice-2] ... [, choice-n])

A Choose função tem estes argumentos:

Argumento Descrição
index Obrigatório. Uma expressão numérica ou um campo que resulta em um valor entre 1 e o número de opções disponíveis.
choice Obrigatório. Uma expressão variante que contém uma das opções possíveis.

Comentários

Choose Retorna um valor da lista de opções com base no valor de index. Se index for 1, Choose retornará a primeira opção na lista. Se index for 2, ele retornará a segunda opção e assim por diante.

Você pode usá-la Choose para pesquisar um valor em uma lista de possibilidades. Por exemplo, se index avaliado como 3 e choice-1 = "um", choice-2 = "dois" e choice-3 = "três", Choose retornará "três". Esse comportamento é útil quando index representa o valor em um grupo de opções.

Choose Avalia todas as opções na lista, mesmo que retorne apenas uma. Devido a esse comportamento, observe os efeitos colaterais indesejados. Por exemplo, se você usar a MsgBox função como parte de uma expressão em todas as opções, o Access exibirá uma caixa de mensagem para cada opção à medida que a avalia, mesmo que Choose retorne o valor de apenas uma opção.

A Choose função retornará Null se index for menor que 1 ou maior que o número de opções listadas.

Se index não for um número inteiro, o Access arredondará para o número inteiro mais próximo antes de avaliá-lo.

Exemplos de consulta

Expressão. Resultados
SELECT Choose(3,"Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec") AS Expr1 FROM ProductSales; Retorna o terceiro valor da lista de valores. Resultado: "Mar".
SELECT DateofSale, Choose(Month(DateofSale),"Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec") AS MonthName FROM ProductSales; Retorna os valores e DateofSale o nome do mês correspondente na MonthName coluna. Month(DateofSale)Retorna o número do mês para DateofSaleChoose e usa esse número como o índice para a lista de opções.

Exemplo de VBA

Observação

Os exemplos a seguir mostram como usar essa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione 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 Choose função para exibir um nome para um índice que o procedimento passa no Ind parâmetro.

Function GetChoice(Ind As Integer)
    GetChoice = Choose(Ind, "Speedy", "United", "Federal")
End Function