Compartilhar via


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

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

Para chamar um procedimento de função dentro de uma expressão

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

  2. Siga o nome do procedimento com parênteses para incluir a lista de argumentos. Se não houver argumentos você pode, opcionalmente, omitir os parênteses. No entanto, o uso dos parênteses facilita a leitura do código.

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

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

  4. O valor retornado do procedimento participa da expressão exatamente como o valor de uma variável ou constante faria.

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

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

  2. Siga o nome do procedimento com parênteses para incluir a lista de argumentos. Se não houver argumentos você pode, opcionalmente, omitir os parênteses. No entanto, o uso dos parênteses facilita a leitura do código.

  3. Coloque os argumentos na lista de argumentos dentro de 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 passe 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 usa 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")

Confira também