Switch-FunktionSwitch function

Wertet eine Liste von Ausdrücken aus und gibt einen Variant-Wert oder einen Ausdruck zurück, der dem ersten Ausdruck in der Liste zugeordnet ist, der True ergibt.Evaluates a list of expressions and returns a Variant value or an expression associated with the first expression in the list that is True.

SyntaxSyntax

Switch (expr-1, Wert-1, [ expr-2, value-2..., [ expr-n, value-n ]])Switch(expr-1, value-1, [ expr-2, value-2…, [ expr-n, value-n ]])


Die Syntax der Switch-Funktion besteht aus folgenden Teilen:The Switch function syntax has these parts:

TeilPart BeschreibungDescription
exprexpr Erforderlich.Required. Variant-Ausdruck , den Sie auswerten möchten.Variant expression that you want to evaluate.
valuevalue Erforderlich.Required. Wert oder Ausdruck, der zurückgegeben werden soll, wenn der entsprechende Ausdruck True ergibt.Value or expression to be returned if the corresponding expression is True.

BemerkungenRemarks

Die Argumentliste der Switch-Funktion enthält Paare von Ausdrücken und Werten.The Switch function argument list consists of pairs of expressions and values. Die Ausdrücke werden von links nach rechts ausgewertet, und es wird der Wert des ersten Ausdrucks zurückgegeben, der True ergibt.The expressions are evaluated from left to right, and the value associated with the first expression to evaluate to True is returned.

Wenn die Teile nicht richtig paarweise angegeben sind, tritt ein Laufzeitfehler auf.If the parts aren't properly paired, a run-time error occurs. Beispiel: Wenn expr-1 den Wert True ergibt, gibt Switchvalue-1 zurück.For example, if expr-1 is True, Switch returns value-1. Wenn expr-1 den Wert False, aber expr-2 den Wert True ergibt, gibt Switchvalue-2 zurück usw.If expr-1 is False, but expr-2 is True, Switch returns value-2, and so on.

Switch gibt in den folgenden Fällen einen Null-Wert zurück:Switch returns a Null value if:

  • Keiner der Ausdrücke ergibt True.None of the expressions is True.

  • Der entsprechende Wert für den Ausdruck, der True ergibt, ist Null.The first True expression has a corresponding value that is Null.

Switch wertet alle Ausdrücke aus, auch wenn nur ein Wert zurückgegeben wird.Switch evaluates all of the expressions, even though it returns only one of them. Das kann zu unerwünschten Nebeneffekten führen.For this reason, you should watch for undesirable side effects. Wenn beispielsweise die Berechnung eines Ausdrucks aufgrund einer Division durch Null zu einem Fehler führt, tritt ein Fehler auf.For example, if the evaluation of any expression results in a division by zero error, an error occurs.

BeispielExample

Dieses Beispiel gibt mit der Switch-Funktion den Namen einer Sprache zurück, die dem Namen einer Stadt zugeordnet ist.This example uses the Switch function to return the name of a language that matches the name of a city.

Function MatchUp(CityName As String)
    Matchup = Switch(CityName = "London", "English", CityName _
                    = "Rome", "Italian", CityName = "Paris", "French")
End Function

Siehe auchSee also

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.