Funzione Switch

Articolo
09/12/2008

Aggiornamento: novembre 2007

Valuta un elenco di espressioni e restituisce un valore Object corrispondente alla prima espressione True dell'elenco.

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

Parametri

VarExpr
Obbligatorio. Matrice di parametri di tipo Object composta necessariamente da elementi in numero pari. È possibile specificare un elenco di variabili o espressioni di tipo Object separate da virgole oppure una matrice unidimensionale di elementi di tipo Object.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	Il numero degli argomenti è dispari.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

L'argomento specificato per VarExpr è costituito da coppie di valori ed espressioni. La funzione Switch valuta le espressioni dispari dall'indice più basso a quello più alto in VarExpr e restituisce il valore pari associato alla prima espressione che restituisce True. Ad esempio, se VarExpr(0) è True, Switch restituisce VarExpr(1), se VarExpr(0) è False ma VarExpr(2) è True, Switch restituisce VarExpr(3) e così via.

Se l'argomento VarExpr non viene specificato, Switch restituirà Nothing.

Nota:
Le espressioni nell'elenco degli argomenti possono includere chiamate di funzione. Durante la fase preparatoria dell'elenco di argomenti per la chiamata alla funzione Switch vengono chiamate tutte le funzioni in tutte le espressioni dal compilatore di Visual Basic. Non è quindi possibile contare sulla mancata chiamata di una determinata funzione se un'espressione precedente nell'elenco degli argomenti restituisce True.

Le espressioni nell'elenco degli argomenti possono includere chiamate di funzione. Durante la fase preparatoria dell'elenco di argomenti per la chiamata alla funzione Switch vengono chiamate tutte le funzioni in tutte le espressioni dal compilatore di Visual Basic. Non è quindi possibile contare sulla mancata chiamata di una determinata funzione se un'espressione precedente nell'elenco degli argomenti restituisce True.

Esempio

Nell'esempio riportato di seguito la funzione Switch viene utilizzata per restituire il nome della lingua corrispondente al nome di una città. È necessario che Option Strict sia 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

Poiché lo spazio dei nomi System.Diagnostics contiene anche una classe denominata Switch, è necessario che una chiamata alla funzione Switch venga qualificata con lo spazio dei nomi Microsoft.VisualBasic.