Compartilhar via


Instrução Exit (Visual Basic)

Sai de um procedimento ou bloqueia e transfere o controle imediatamente para a instrução após a chamada de procedimento ou a definição do bloco.

Sintaxe

Exit { Do | For | Function | Property | Select | Sub | Try | While }

Instruções

Exit Do
Sai imediatamente do Do loop no qual ele aparece. A execução continua com a instrução após a Loop instrução. Exit Do pode ser usado somente dentro de um Do loop. Quando usado em loops aninhados Do , Exit Do sai do loop mais interno e transfere o controle para o próximo nível mais alto de aninhamento.

Exit For
Sai imediatamente do For loop no qual ele aparece. A execução continua com a instrução após a Next instrução. Exit Forpode ser usado somente dentro de um Forloop ...Next ouFor Each...Next Quando usado em loops aninhados For , Exit For sai do loop mais interno e transfere o controle para o próximo nível mais alto de aninhamento.

Exit Function
Sai imediatamente do Function procedimento no qual ele aparece. A execução continua com a instrução após a instrução que chamou o Function procedimento. Exit Function pode ser usado somente dentro de um Function procedimento.

Para especificar um valor retornado, você pode atribuir o valor ao nome da função em uma linha antes da instrução Exit Function . Para atribuir o valor retornado e sair da função em uma instrução, você pode usar a Instrução Return.

Exit Property
Sai imediatamente do Property procedimento no qual ele aparece. A execução continua com a instrução que chamou o Property procedimento, ou seja, com a instrução solicitando ou definindo o valor da propriedade. Exit Property pode ser usado somente dentro de Get uma propriedade ou Set procedimento.

Para especificar um valor retornado em um Get procedimento, você pode atribuir o valor ao nome da função em uma linha antes da Exit Property instrução. Para atribuir o valor retornado e sair do Get procedimento em uma instrução, você pode usar a Return instrução.

Em um Set procedimento, a instrução Exit Property é equivalente à instrução Return .

Exit Select
Sai imediatamente do Select Case bloco no qual ele aparece. A execução continua com a instrução após a End Select instrução. Exit Select pode ser usado somente dentro de uma Select Case instrução.

Exit Sub
Sai imediatamente do Sub procedimento no qual ele aparece. A execução continua com a instrução após a instrução que chamou o Sub procedimento. Exit Sub pode ser usado somente dentro de um Sub procedimento.

Em um Sub procedimento, a instrução Exit Sub é equivalente à instrução Return .

Exit Try
Sai imediatamente do Try bloco ou do Catch bloco no qual ele aparece. A execução continuará com o Finally bloco se houver um ou com a instrução seguindo a instrução de End Try outra forma. Exit Try pode ser usado somente dentro de um Try ou Catch bloco, e não dentro de um Finally bloco.

Exit While
Sai imediatamente do While loop no qual ele aparece. A execução continua com a instrução após a End While instrução. Exit While pode ser usado somente dentro de um While loop. Quando usado em loops aninhados While , Exit While transfere o controle para o loop que é um nível aninhado acima do loop em Exit While que ocorre.

Observações

Não confunda Exit instruções com End instruções. Exit não define o final de uma instrução.

Exemplo 1

No exemplo a seguir, a condição de loop interrompe o loop quando a index variável é maior que 100. A If instrução no loop, no entanto, faz com que a Exit Do instrução interrompa o loop quando a variável de índice for maior que 10.

Dim index As Integer = 0
Do While index <= 100
    If index > 10 Then
        Exit Do
    End If

    Debug.Write(index.ToString & " ")
    index += 1
Loop

Debug.WriteLine("")
' Output: 0 1 2 3 4 5 6 7 8 9 10 

Exemplo 2

O exemplo a seguir atribui o valor retornado ao nome myFunctionda função e, em seguida, usa Exit Function para retornar da função:

Function MyFunction(ByVal j As Integer) As Double
    MyFunction = 3.87 * j
    Exit Function
End Function

Exemplo 3

O exemplo a seguir usa a Instrução Return para atribuir o valor retornado e sair da função:

Function MyFunction(ByVal j As Integer) As Double
    Return 3.87 * j
End Function

Consulte também