Partilhar via


Como: Chamar um procedimento que retorna um valor (Visual Basic)

Um Function procedimento retorna um valor para o código de chamada. Você o chama incluindo seu nome e argumentos no lado direito de uma instrução de atribuição ou em uma expressão.

Para chamar um procedimento Function dentro de uma expressão

  1. Use o nome do Function procedimento da mesma forma que usaria uma variável. Você pode usar uma chamada de Function procedimento em qualquer lugar que possa usar uma variável ou constante em uma expressão.

  2. Siga o nome do procedimento entre parênteses para incluir a lista de argumentos. Se não houver argumentos, você pode, opcionalmente, omitir os parênteses. No entanto, usar os parênteses torna seu código mais fácil de ler.

  3. Coloque os argumentos na lista de argumentos entre parênteses, separados por vírgulas. Certifique-se de fornecer os argumentos na mesma ordem em que o Function procedimento define os parâmetros correspondentes.

    Como alternativa, você pode passar um ou mais argumentos pelo nome. Para obter mais informações, consulte Passando argumentos por posição e por nome.

  4. O valor retornado do procedimento participa da expressão da mesma forma que o valor de uma variável ou constante.

Para chamar um procedimento Function em uma instrução de atribuição

  1. Use o nome do Function procedimento após o sinal de igual (=) na instrução de atribuição.

  2. Siga o nome do procedimento entre parênteses para incluir a lista de argumentos. Se não houver argumentos, você pode, opcionalmente, omitir os parênteses. No entanto, usar os parênteses torna seu código mais fácil de ler.

  3. Coloque os argumentos na lista de argumentos entre parênteses, separados por vírgulas. Certifique-se de fornecer os argumentos na mesma ordem em que o Function procedimento define os parâmetros correspondentes, a menos que você os esteja passando pelo nome.

  4. O valor retornado do procedimento é armazenado na variável ou propriedade no lado esquerdo da instrução de atribuição.

Exemplo

O exemplo a seguir chama o Visual Basic Environ para recuperar o valor de uma variável de ambiente do sistema operacional. A primeira linha chama Environ dentro de uma expressão e a segunda linha a chama em uma instrução de atribuição. Environ toma o nome da variável como seu único argumento. Ele retorna o valor da variável para o código de chamada.

MsgBox("Value of PATH is " & Environ("PATH"))
Dim currentPath As String = Environ("PATH")

Consulte também