Compartilhar via


Como: Passar argumentos para um procedimento por nome

Quando você telefonar um Sub ou Function procedimento, você pode passar argumentos para ele por nome, sem considerar a ordem na qual os parâmetros correspondentes aparecem na definição do procedimento.

Passando argumentos com nome facilita a leitura, pois fornecem significado para os valores de argumento na telefonar de procedimento de seu código de telefonar.Se o procedimento tiver parâmetros opcionais, passando pelo nome também torna mais fácil controlar quais argumentos que você está passando e quais deles será omitido.

Para obter regras e restrições para fornecer argumentos por nome, consulte Passagem de Argumentos por Posição e Nome.

Para passar um argumento por nome

  1. Examine o código de fonte da declaração do procedimento para determinar a ortografia dos nomes de parâmetro exata.

  2. No código de telefonar, Preparar-se a telefonar de procedimento da maneira normal, com a lista de argumento entre parênteses após o nome do procedimento.

  3. Para cada argumento pretenda passar pelo nome, forneça o nome do parâmetro declarados seguido por dois-pontos e um sinal de igual (:=), seguido pelo valor que você está passando para o argumento.

  4. Você pode fornecer argumentos nomeados em qualquer ordem, mas você deve fornecer todos os argumentos posicionais antes de fornecer argumentos nomeados.

Exemplo

O exemplo a seguir mostra um Sub procedimento com três parâmetros e um Chamar demonstrativo (Visual Basic) que passa argumentos para esses parâmetros por nome.

Sub studentInfo(ByVal name As String, _
       Optional ByVal age As Short = 0, _
       Optional ByVal birth As Date = #1/1/2000#)

  Debug.WriteLine("Name = " & name & _
                "; age = " & CStr(age) & _
                "; birth date = " & CStr(birth))
End Sub
Call studentInfo(age:=19, birth:=#9/21/1981#, name:="Mary")

Quando você psistema autônomos argumentos por nome, você não é necessário fornecê-las na mesma ordem sistema autônomo o procedimento declara-los.

Compilando o código

Certifique-se de que o nome de parâmetro na lista de argumento corresponde exatamente ao nome declarado pelo procedimento.

Consulte também

Tarefas

Como: Passar argumentos para um procedimento

Conceitos

Procedimentos no Visual Basic

Parâmetros do procedimento e argumentos

Argumento Passing By valor e por referência

Passagem de Argumentos por Posição e Nome

Parâmetros Opcionais

Matrizes de parâmetro

Referência

Opcional (Visual Basic)

ParamArray