Switch, fonction

Article
09/12/2008

Mise à jour : novembre 2007

Évalue une liste d'expressions et retourne une valeur Object correspondant à la première expression de la liste qui est True.

Public Function Switch( _
    ByVal ParamArray VarExpr() As Object _
) As Object

Paramètres

VarExpr
Requis. Tableau de paramètres Object. Doit comprendre un nombre pair d'éléments. Vous pouvez fournir une liste de variables ou d'expressions Object séparées par des virgules, ou un tableau unidimensionnel d'éléments Object.

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentException	5	Nombre impair d'arguments

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion non structurée des erreurs. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

L'argument fourni à VarExpr composé d'expressions et de valeurs fonctionnant par paires. La fonction Switch évalue les expressions impaires de l'index le plus bas à l'index le plus élevé dans VarExpr, et retourne la valeur paire associée à la première expression qui a la valeur True. Par exemple, si VarExpr(0) a la valeur True, Switch retourne VarExpr(1), et si VarExpr(0) a la valeur False, mais VarExpr(2) est True, Switch retourne VarExpr(3), et ainsi de suite.

Si vous ne fournissez pas l'argument VarExpr, Switch retourne Nothing.

Remarque :
Les expressions dans la liste d'arguments peuvent inclure des appels de fonction. Pour préparer la liste d'arguments pour l'appel à Switch, le compilateur Visual Basic appelle chaque fonction de chaque expression. Ceci signifie qu'une fonction particulière sera appelée si une expression précédente de la liste d'arguments est True.

Exemple

L'exemple suivant utilise la fonction Switch pour retourner le nom de la langue correspondant au nom d'une ville. Option Strict doit être Off.

Function matchLanguage(ByVal cityName As String) As String
    Return CStr(Microsoft.VisualBasic.Switch( _
        cityName = "London", "English", _
        cityName = "Rome", "Italian", _
        cityName = "Paris", "French"))
End Function

Comme l'espace de noms System.Diagnostics contient également une classe appelée Switch, un appel à la fonction Switch doit être qualifié avec l'espace de noms Microsoft.VisualBasic.