Évalue une liste d’expressions et renvoie une valeur Variante ou une expression associée à la première expression de la liste qui a la valeur Vrai.
Syntaxe
Switch( expr-1, value-1 [, expr-2, value-2 ] ... [, expr-n, value-n ] )
La syntaxe de la fonction Switch contient les arguments suivants :
Argument |
Description |
expr |
Obligatoire. Expression variant que vous souhaitez évaluer. |
valeur |
Obligatoire. Valeur ou expression à retourner si l’expression correspondante a la valeur True. |
Notes
La liste de argument fonction Switch se compose de paires d’expressions et de valeurs. Les expressions sont évaluées de gauche à droite, et la valeur associée à la première expression à évaluer à True est retournée. Si les parties ne sont pas correctement appairées, une erreur d’exécution se produit. Par exemple, si expr-1 a la valeur True, Switch retourne la valeur 1. Si expr-1 a la valeur False, mais que expr-2 a la valeur True, Switch renvoie la valeur 2, et ainsi de suite.
Switch retourne une valeur Null si :
-
Aucune des expressions n’a la valeur True.
-
La première expression True a une valeur correspondante qui est Null.
Switch évalue toutes les expressions, même s’il ne retourne qu’une seule d’entre elles. Pour cette raison, vous devez watch pour les effets secondaires indésirables. Par exemple, si l’évaluation d’une expression entraîne une erreur de division par zéro, une erreur se produit.
Exemple de requête
Expression |
Résultats |
SELECT ProductSales.ProductID, Switch([ProductID]="PRO_XYZ1 »,"First »,[ProductID]="PRO_XYZ2 »,"Two »,[ProductID]="PRO_XYZ1 »,"Ten ») AS testSwitch FROM ProductSales ; |
Retourne le « ProductID », évalue les expressions dans la formule « Switch » et change les valeurs existantes avec des valeurs définies pour toutes les expressions « True ». Par exemple : « PRO_XYZ1 » est remplacé par « First », « PRO_XYZ2 » est remplacé par « Two », etc. |
Exemple VBA
Remarque : Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence du développeur dans la liste déroulante en regard de Rechercher et entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple utilise la fonction Switch pour renvoyer le nom d’une langue qui correspond au nom d’une ville.
Function MatchUp (CityName As String)
Matchup = Switch(CityName = "London", "English", _ CityName = "Rome", "Italian", _ CityName = "Paris", "French") End Function