Instrução Return (Visual Basic)

  • Artigo

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

Confira também