Switch (Función)

Artículo
10/07/2008

Actualización: noviembre 2007

Evalúa una lista de expresiones y devuelve un valor de Object que se corresponde con la primera expresión de la lista que es True.

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

Parámetros

VarExpr
Obligatorio. Matriz de parámetros Object. Debe tener un número par de elementos. Puede proporcionar una lista de variables o expresiones Object separadas por comas, o una matriz unidimensional de elementos Object.

Excepciones

Tipo de excepción	Número de error	Condición
ArgumentException	5	El número de argumentos es impar.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, debe considerarse la posibilidad de sustituir dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

El argumento proporcionado para VarExpr está compuesto de valores y expresiones emparejadas. La función Switch evalúa las expresiones numeradas impares desde el índice más bajo al más alto en VarExpr, y devuelve el valor numérico par asociado a la primera expresión que se evalúa como True. Por ejemplo, si VarExpr(0) es True, Switch devuelve VarExpr(1) y si VarExpr(0) es False pero VarExpr(2) es True, Switch devuelve VarExpr(3), etc.

Si no se proporciona el argumento VarExpr, Switch devuelve Nothing.

Nota:
Las expresiones de la lista de argumentos pueden incluir llamadas a funciones. Mientras prepara la lista de argumentos para llamar a la función Switch, el compilador de Visual Basic llama a cada una de las funciones de todas las expresiones. Esto significa que no puede confiar en que no se esté llamando a una función determinada si una expresión anterior de la lista de argumentos es True.

Ejemplo

En el ejemplo siguiente se utiliza la función Switch para devolver el nombre de un idioma que coincide con el nombre de una ciudad. Requiere que Option Strict sea 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

Dado que el espacio de nombres System.Diagnostics contiene también una clase denominada Switch, las llamadas a la función Switch deben calificarse con el espacio de nombres Microsoft.VisualBasic.