Return, instruction (Visual Basic)

Article
09/12/2008

Mise à jour : novembre 2007

Retourne le contrôle au code qui a appelé une procédure Function, Sub, Get, Set ou Operator.

Return
-or-
Return expression

Élément

expression
Obligatoire dans une procédure Function, Get ou Operator. Expression qui représente la valeur à retourner au code appelant.

Notes

Dans une procédure Sub ou Set, l'instruction Return est équivalente à une instruction Exit SubExit Property, et expression ne doit pas être fourni.

Dans une procédure Function, Get ou Operator, l'instruction Return doit contenir expression, et expression doit avoir pour valeur un type de données convertible vers le type de retour de la procédure. Dans une procédure Function ou Get, vous pouvez également assigner une expression au nom de la procédure pour servir de valeur de retour, puis exécuter une instruction Exit Function ou Exit Property. Dans une procédure Operator, vous devez utiliser Returnexpression.

Vous pouvez inclure autant d'instructions Return que nécessaire dans la même procédure.

Remarque :
Le code d'un bloc Finally est exécuté après que le programme rencontre une instruction Return dans un bloc Try ou Catch, mais avant que cette instruction Return ne soit exécutée. Dans ce cas, une instruction Return dans le bloc Finally s'exécute avant l'instruction Return initiale. Cela donne une valeur de retour différente. Pour éviter cette situation potentiellement source de confusion, évitez d'utiliser des instructions Return dans les blocs Finally.

Le code d'un bloc Finally est exécuté après que le programme rencontre une instruction Return dans un bloc Try ou Catch, mais avant que cette instruction Return ne soit exécutée. Dans ce cas, une instruction Return dans le bloc Finally s'exécute avant l'instruction Return initiale. Cela donne une valeur de retour différente. Pour éviter cette situation potentiellement source de confusion, évitez d'utiliser des instructions Return dans les blocs Finally.

Exemple

L'exemple suivant utilise plusieurs fois l'instruction Return pour retourner au code appelant lorsque la procédure ne doit pas effectuer d'autres opérations.

Public Function getAgePhrase(ByVal age As Integer) As String
    If age > 60 Then Return "Senior"
    If age > 40 Then Return "Middle-aged"
    If age > 20 Then Return "Adult"
    If age > 12 Then Return "Teen-aged"
    If age > 4 Then Return "School-aged"
    If age > 1 Then Return "Toddler"
    Return "Infant"
End Function