Instrução Return (Visual Basic)
Retorna o controle para o código que chamou um procedimento Function
, Sub
, Get
, Set
ou Operator
.
Sintaxe
Return
' -or-
Return expression
Parte
expression
Obrigatório em um procedimento Function
, Get
ou Operator
. Expressão que representa o valor a ser retornado ao código de chamada.
Comentários
Em um procedimento Sub
ou Set
, a instrução Return
é equivalente a uma instrução Exit Sub
ou Exit Property
e expression
não deve ser fornecida.
Em um procedimento Function
, Get
ou Operator
, a instrução Return
deve incluir expression
, e expression
deve ser avaliada como um tipo de dados que seja conversível no tipo de retorno do procedimento. Em um procedimento Function
ou Get
, você também tem a alternativa de atribuir uma expressão ao nome do procedimento para servir como o valor retornado e executar uma instrução Exit Function
ou Exit Property
. Em um procedimento Operator
, você deve usar Return expression
.
Você pode incluir quantas instruções Return
forem apropriadas no mesmo procedimento.
Observação
O código em um bloco Finally
é executado depois que uma instrução Return
em um bloco Try
ou Catch
é encontrada, mas antes que essa instrução Return
seja executada. Uma instrução Return
não pode ser incluída em um bloco Finally
.
Exemplo
O exemplo a seguir usa a instrução Return
várias vezes para retornar ao código de chamada quando o procedimento não precisa fazer mais nada.
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