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