Switch-Funktion

Artikel
09/02/2008

Aktualisiert: November 2007

Werte eine Liste von Ausdrücken aus und gibt einen Object-Wert zurück, entsprechend dem ersten Ausdruck in der Liste, der True ist.

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

Parameter

VarExpr
Erforderlich. Object-Parameterarray. Muss eine gerade Zahl von Elementen aufweisen. Sie können eine durch Komma getrennte Liste von Object-Variablen oder -Ausdrücken oder ein eindimensionales Array von Object-Elementen angeben.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Ungerade Anzahl der Argumente

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Das für VarExpr angegebene Argument besteht aus paarweise zugeordneten Ausdrücken und Werten. Die Switch-Funktion wertet die ungeradzahligen Ausdrücke vom niedrigsten zum höchsten Index in VarExpr aus und gibt den geradzahligen Wert aus, der dem ersten Ausdruck zugeordnet ist, der zu True ausgewertet wird. Wenn VarExpr(0) beispielsweise True ist, gibt SwitchVarExpr(1) zurück, und wenn VarExpr(0)False ist, VarExpr(2) aber True ist, dann gibt SwitchVarExpr(3) zurück usw.

Wenn Sie das VarExpr-Argument nicht angeben, gibt Switch den Wert Nothing zurück.

Hinweis:
Die Ausdrücke in der Argumentliste können Funktionsaufrufe enthalten. Die Argumentliste wird auf den Aufruf der Switch-Funktion vorbereitet, indem jede Funktion in jedem Ausdruck mit dem Visual Basic-Compiler aufgerufen wird. Das heißt, Sie können nicht davon ausgehen, dass eine bestimmte Funktion nicht aufgerufen wird, wenn ein vorheriger Ausdruck in der Argumentliste True ist.

Beispiel

Im folgenden Beispiel wird die Switch-Funktion verwendet, um den Namen einer Sprache zurückzugeben, die dem Namen einer Stadt zugeordnet ist. Es wird vorausgesetzt, dass Option Strict den Wert Off hat.

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

Weil der System.Diagnostics-Namespace auch eine Klasse mit dem Namen Switch enthält, muss der Microsoft.VisualBasic-Namespace im Aufruf der Switch-Funktion angegeben werden.