Como: Passar argumentos para um procedimento por nome (Visual Basic)
Quando você chama um Sub ou Function procedimento, você pode passar argumentos para que ele pelo nome,, sem considerar a ordem na qual os parâmetros correspondentes aparecem na definição do procedimento.
Passando argumentos por nome facilita a leitura, pois ele oferece um significado para os valores de argumento na chamada de procedimento de código de chamada. Se o procedimento tem parâmetros opcionais, passando pelo nome também torna mais fácil controlar quais argumentos que você está passando e quais será omitido.
Para regras e restrições para fornecer argumentos por nome, consulte Passagem de argumentos por posição e nome (Visual Basic).
Para passar um argumento por nome
Examine o código fonte do procedimentode declaração para determinar a grafia exata dos nomes de parâmetro .
No código de chamada, prepare-se a chamada de procedimento da maneira normal, com a lista de argumento entre parênteses após o nome do procedimento .
Para cada argumento pretende passar pelo nome, fornecer seguido por uma vírgula e um sinal de igual de nome declarado do parâmetro(:=), em seguida, o valor que você está passando para o argumento.
Você pode fornecer argumentos nomeados em qualquer ordem, mas você deve fornecer todos os argumentos posicionais antes de fornecer argumentos nomeados.
Exemplo
A exemplo a seguir mostra um Suboprocedimento com três parâmetros e um Instrução Call (Visual Basic) que passa os 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ê passar argumentos por nome, não é necessário fornecê-las na mesma ordem, conforme o procedimento declara-los.
Compilando o código
Verifique se que o nome do parâmetro na lista do argumento corresponde exatamente ao nome declarado pelo procedimento.
Consulte também
Tarefas
Como: Passar argumentos para um procedimento (Visual Basic)
Referência
Conceitos
Parâmetros e argumentos de procedimento (Visual Basic)
Passando argumentos por valor e por referência (Visual Basic)
Passagem de argumentos por posição e nome (Visual Basic)