Share via


Como chamar um procedimento que retorna um valor (Visual Basic)

Um procedimento Function 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 em uma expressão

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

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

  3. Coloque os argumentos na lista de argumentos dentro de parênteses, separados por vírgulas. Não se esqueça de fornecer os argumentos na mesma ordem que o procedimento Function define os parâmetros correspondentes.

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

  4. O valor retornado do procedimento participa na expressão apenas como o valor de uma variável ou constante participaria.

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

  1. Use o nome da propriedade Function seguido do sinal de igual (=) em uma instrução de atribuição.

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

  3. Coloque os argumentos na lista de argumentos dentro de parênteses, separados por vírgulas. Não se esqueça de fornecer os argumentos na mesma ordem em que o procedimento Function define os parâmetros correspondentes, a menos que você esteja passando-os por 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 em uma expressão, e a segunda linha chama-o em uma instrução de atribuição. Environ utiliza o nome de 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

Tarefas

Como criar um procedimento que retorne um valor (Visual Basic)

Como retornar um valor de um procedimento (Visual Basic)

Como chamar um procedimento que não retorne um valor (Visual Basic)

Referência

Instrução Function (Visual Basic)

Conceitos

Procedimentos de função (Visual Basic)

Parâmetros e argumentos de procedimento (Visual Basic)