Wyznacza wartość listy wyrażeń i zwraca wartość typu wariant lub wyrażenie skojarzone z pierwszym wyrażeniem na liście, które ma wartość Prawda.
Składnia
Switch( wyr-1, wartość-1 [, wyr-2, wartość-2 ] ... [, wyr-n, wartość-n ] )
W składni funkcji Przełącz występują następujące argumenty:
Argument |
Opis |
wyrażenie |
Argument wymagany. Wyrażenie typu wariant, które ma zostać obliczone. |
wartość |
Argument wymagany. Wartość lub wyrażenie, które mają zostać zwrócone, jeśli odpowiadające im wyrażenie ma wartość Prawda. |
Uwagi
Lista argument funkcji Przełącz składa się z par wyrażeń i wartości. Wyrażenia są obliczane od lewej do prawej strony, a zwracana jest wartość skojarzona z pierwszym wyrażeniem, które ma obliczyć wartość Prawda . Jeśli części nie są prawidłowo sparowane, występuje błąd czasu wykonania. Jeśli na przykład wyrażenie-1 ma wartość Prawda, funkcja Przełącz zwraca wartość-1. Jeśli wyrażenie-1 ma wartość Fałsz, ale wyrażenie-2 ma wartość Prawda, przełącznik zwraca wartość-2 itd.
Przełącznik zwraca wartość Null, jeśli:
-
Żadne z wyrażeń nie ma wartości True (Prawda).
-
Pierwsze wyrażenie Prawda ma odpowiadającą jej wartość Null.
Funkcja Przełącz ocenia wszystkie wyrażenia, mimo że zwraca tylko jedno z nich. Z tego powodu, należy watch dla niepożądanych skutków ubocznych. Jeśli na przykład oszacowanie dowolnego wyrażenia powoduje błąd dzielenia przez zero, występuje błąd.
Przykład kwerendy
Expression |
Wyniki |
SELECT ProductSales.ProductID, Switch([ProductID]="PRO_XYZ1","First",[ProductID]="PRO_XYZ2","Two",[ProductID]="PRO_XYZ1","Ten") AS testSwitch FROM ProductSales; |
Zwraca wartość "ProductID", oblicza wyrażenia w formule "Przełącz" i przełącza istniejące wartości ze zdefiniowanymi wartościami dla wszystkich wyrażeń "True". Na przykład: ciąg "PRO_XYZ1" jest zamieniany na "Pierwszy", ciąg "PRO_XYZ2" jest zamieniany na "Dwa" itd. |
Przykład języka VBA
Uwaga: Poniższe przykłady przedstawiają sposób użycia tej funkcji w module języka Visual Basic for Applications (VBA). Aby uzyskać dodatkowe informacje na temat pracy w języku VBA, wybierz pozycję Dokumentacja dewelopera z listy rozwijanej obok przycisku Wyszukaj i wprowadź odpowiednie terminy w polu wyszukiwania.
W tym przykładzie użyto funkcji Przełącz w celu zwrócenia nazwy języka zgodnego z nazwą miasta.
Function MatchUp (CityName As String)
Matchup = Switch(CityName = "London", "English", _ CityName = "Rome", "Italian", _ CityName = "Paris", "French") End Function