Como: Chamar um procedimento que retorna um valor

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.

Você pode usar a palavra-chave Call para chamar um procedimento Function.No entanto, essa técnica ignora o valor retornado pelo procedimento.

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 obter mais informações, consulte Passagem de Argumentos por Posição e Nome.

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 Função 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 chama-lo em uma demonstrativo de atribuição. Environ aceita o nome da variável sistema autônomo 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 retorna um valor

Como: Retornar um valor de um procedimento

Como: telefonar um procedimento que não retorna um valor

Conceitos

Procedimentos de função

Parâmetros do procedimento e argumentos

Referência

Instrução Function (Visual Basic)